home *** CD-ROM | disk | FTP | other *** search
/ World of Education / World of Education.iso / world_q / qasa391.zip / Q&ASA.DOC next >
Text File  |  1992-04-28  |  123KB  |  3,288 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                              Q & A Study Aid (Q&ASA)
  13.  
  14.                                   User's Guide
  15.  
  16.                                   Version 3.91
  17.  
  18.                                  April 26, 1992
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                                     _______
  40.                                ____|__     |                (R)
  41.                             --|       |    |-------------------
  42.                               |   ____|__  |  Association of
  43.                               |  |       |_|  Shareware
  44.                               |__|   o   |    Professionals
  45.                             -----|   |   |---------------------
  46.                                  |___|___|    MEMBER
  47.  
  48.  
  49.  
  50.  
  51.                                   Hal Endresen
  52.                               Quid Pro Quo Software
  53.                                   P.O. Box 1248
  54.                            Cedar Rapids, IA 52406-1248
  55.                            CompuServe ID [73760,2032]
  56.  
  57.  
  58.      Q&A Study Aid V3.91 User's Guide
  59.  
  60.  
  61.                                 Table Of Contents
  62.                                 -----------------
  63.  
  64.      The Association of Shareware Professionals  . . . . . . . . . . .    1
  65.  
  66.      Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  67.  
  68.      Revision Information  . . . . . . . . . . . . . . . . . . . . . .    1
  69.  
  70.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  71.  
  72.      Installation  . . . . . . . . . . . . . . . . . . . . . . . . . .    8
  73.  
  74.      Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  75.  
  76.      A Special Note  . . . . . . . . . . . . . . . . . . . . . . . . .   10
  77.  
  78.      User Interface  . . . . . . . . . . . . . . . . . . . . . . . . .   12
  79.  
  80.      Q&ASA Command List  . . . . . . . . . . . . . . . . . . . . . . .   13
  81.  
  82.      The Command Line  . . . . . . . . . . . . . . . . . . . . . . . .   13
  83.  
  84.      /FL - Load A Database . . . . . . . . . . . . . . . . . . . . . .   14
  85.  
  86.      /FS - Save a Database . . . . . . . . . . . . . . . . . . . . . .   16
  87.  
  88.      /FC - Continue with a Saved Database  . . . . . . . . . . . . . .   17
  89.  
  90.      /FD - Shell To DOS  . . . . . . . . . . . . . . . . . . . . . . .   17
  91.  
  92.      /FX - Exit to DOS . . . . . . . . . . . . . . . . . . . . . . . .   17
  93.  
  94.      /MS - Sequential Mode . . . . . . . . . . . . . . . . . . . . . .   18
  95.  
  96.      /MR - Pseudorandom Mode . . . . . . . . . . . . . . . . . . . . .   18
  97.  
  98.      /MC - Clear . . . . . . . . . . . . . . . . . . . . . . . . . . .   19
  99.  
  100.      /N - Name . . . . . . . . . . . . . . . . . . . . . . . . . . . .   19
  101.  
  102.      /US - Set Screen Colors . . . . . . . . . . . . . . . . . . . . .   19
  103.  
  104.      /UM - Set Menu Selector Character . . . . . . . . . . . . . . . .   20
  105.  
  106.      /UP - Set Password  . . . . . . . . . . . . . . . . . . . . . . .   20
  107.  
  108.      /UC - Invoke Q&ASA Compiler . . . . . . . . . . . . . . . . . . .   20
  109.  
  110.      /UD - Decrypt Score File  . . . . . . . . . . . . . . . . . . . .   21
  111.  
  112.      /UE - Export Score File . . . . . . . . . . . . . . . . . . . . .   21
  113.  
  114.  
  115.  
  116.      Copyright (C) 1988-1992 Hal Endresen, Quid Pro Quo Software     Page i
  117.  
  118.  
  119.      Q&A Study Aid V3.91 User's Guide
  120.  
  121.  
  122.      /UR - Print Registration Form . . . . . . . . . . . . . . . . . .   22
  123.  
  124.      Scoring Window  . . . . . . . . . . . . . . . . . . . . . . . . .   22
  125.  
  126.      Answering Questions . . . . . . . . . . . . . . . . . . . . . . .   23
  127.  
  128.      Creating a Database . . . . . . . . . . . . . . . . . . . . . . .   25
  129.           The Q&ASA Database Compiler  . . . . . . . . . . . . . . . .   30
  130.           Using The Q&ASA Compiler . . . . . . . . . . . . . . . . . .   30
  131.           Q&ASA Language Syntax  . . . . . . . . . . . . . . . . . . .   31
  132.           Terminators  . . . . . . . . . . . . . . . . . . . . . . . .   32
  133.           The Q= and A= Keywords . . . . . . . . . . . . . . . . . . .   32
  134.           The P= Keyword . . . . . . . . . . . . . . . . . . . . . . .   33
  135.           The N= Keyword . . . . . . . . . . . . . . . . . . . . . . .   34
  136.           The M= Keyword . . . . . . . . . . . . . . . . . . . . . . .   34
  137.           The T= Keyword . . . . . . . . . . . . . . . . . . . . . . .   38
  138.           The C= Keyword . . . . . . . . . . . . . . . . . . . . . . .   39
  139.           The S= and R= Keywords . . . . . . . . . . . . . . . . . . .   39
  140.           The F= Keyword . . . . . . . . . . . . . . . . . . . . . . .   39
  141.           The E= Keyword . . . . . . . . . . . . . . . . . . . . . . .   42
  142.           The D= Keyword . . . . . . . . . . . . . . . . . . . . . . .   42
  143.           The W= Keyword . . . . . . . . . . . . . . . . . . . . . . .   42
  144.  
  145.      Conclusion  . . . . . . . . . . . . . . . . . . . . . . . . . . .   44
  146.  
  147.      Appendix : Q&ASA Compiler Error Messages  . . . . . . . . . . . .   45
  148.  
  149.      COPYRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . .   47
  150.  
  151.      DEFINITION OF SHAREWARE . . . . . . . . . . . . . . . . . . . . .   48
  152.  
  153.      DISCLAIMER - AGREEMENT  . . . . . . . . . . . . . . . . . . . . .   48
  154.  
  155.      SPECIAL OFFER!  . . . . . . . . . . . . . . . . . . . . . . . . .   50
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.      Copyright (C) 1988-1992 Hal Endresen, Quid Pro Quo Software    Page ii
  178.  
  179.  
  180.      Q&A Study Aid V3.91 User's Guide
  181.  
  182.  
  183.  
  184.      The Association of Shareware Professionals
  185.      ------------------------------------------
  186.  
  187.      The Association of Shareware Professionals is an organization whose
  188.      purpose is to promote the shareware distribution concept, and to
  189.      provide a forum for the resolution of disputes between ASP members and
  190.      their customers.
  191.  
  192.      Quid Pro Quo Software is a member of the Association of Shareware
  193.      Professionals (ASP).  ASP wants to make sure that the shareware
  194.      principle works for you. If you are unable to resolve a shareware-
  195.      related problem with an ASP member by contacting the member directly,
  196.      ASP may be able to help. The ASP Ombudsman can help you resolve a
  197.      dispute or problem with an ASP member, but does not provide technical
  198.      support for members' products. Please write to the ASP Ombudsman at
  199.      545 Grover Road, Muskegon, MI 49442-9427 or send a Compuserve message
  200.      via CompuServe Mail to ASP Ombudsman 70007,3536.
  201.  
  202.  
  203.      Credits
  204.      -------
  205.  
  206.      Microsoft(R), Microsoft Windows(R), MS-DOS, Microsoft C Optimizing
  207.      Compiler(R), and Microsoft Macro Assembler are registered trademarks
  208.      of Microsoft Corporation.
  209.  
  210.      IBM and PC-DOS are registered trademarks of International Business
  211.      Machines Corporation.
  212.  
  213.      dBASE is a registered trademark of Ashton-Tate.
  214.  
  215.      RTLink/Plus is a registered trademark of Pocket Soft, Inc.
  216.  
  217.      DESQview is a registered trademark of Quarterdeck Office Systems, Inc.
  218.  
  219.      Lotus, Lotus 1-2-3, and 1-2-3 are trademarks of Lotus Development
  220.      Corporation.
  221.  
  222.  
  223.      Revision Information
  224.      --------------------
  225.  
  226.      Version 3.91   April 26, 1992
  227.  
  228.           Added the /UR (Utilities/print Registration form) command. This
  229.           command prompts for all of the information needed to register Q&A
  230.           Study Aid, and prints a form ready to mail, complete with compu-
  231.           tations showing pricing. This feature also determines many of the
  232.           more important features of your computer system so that this
  233.           information is available should you require assistance.
  234.  
  235.      Version 3.90   September 1, 1991
  236.  
  237.  
  238.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 1
  239.  
  240.  
  241.      Q&A Study Aid V3.91 User's Guide
  242.  
  243.  
  244.           Fixed a major bug that caused questions to be skipped in both
  245.           sequential and randow modes. All questions are now properly pre-
  246.           sented in either mode. Thanks to a concerned user in Pennsylvania
  247.           for reporting this error.
  248.  
  249.           Integrated all auxiliary programs into the main program file.
  250.           There is now only one program. Access to the compiler and other
  251.           functions related to the score file is now by password access.
  252.  
  253.           Added a secure password function. Q&ASA is distributed without a
  254.           password. To enable password protection, you must enter a pass-
  255.           word.
  256.  
  257.           Added the ability to export certain fields of the score file in a
  258.           form suitable for importing into other spreadsheet and database
  259.           programs.
  260.  
  261.           Added the ability to associate "letter grades" to scores. Letter
  262.           grades consist of any string up to five characters in length.
  263.           This permits the use of an A..F grading system, or the GPA
  264.           grading system used in colleges and universities; e.g., 4.0 and
  265.           down, or even "PASS/FAIL". There is no defined limit on the
  266.           number of associations between scores and letter grades.
  267.  
  268.           Added the ability to exclude all punctuation from an answer list
  269.           and from the user's response. This allows the answer list to be
  270.           shorter, and permits numbers with commas to be scored correctly
  271.           if the commas are omitted.
  272.  
  273.           Added code to detect self-referential macros, now matter how
  274.           deeply recursive the nesting may be. Q&ASA can no longer crash if
  275.           self-referential macros are inadvertently specified.
  276.  
  277.           Added a test to lock out the /N (Name) command once a database
  278.           with score file logging has been loaded and a name has been
  279.           entered. This prevents a user from changing his or her name if
  280.           the score is low.
  281.  
  282.           Added the "Utilities" menu that provides access to the password-
  283.           setting function, the compiler, score file utilities, menu
  284.           selector character, and color selection, as follows:
  285.  
  286.                o    The /UM command sets the menu selector character.
  287.                o    The /US command sets the screen colors.
  288.                o    The /UP command sets the password.
  289.                o    The /UC command executes the compiler.
  290.                o    The /UD command is used to convert an encrypted score
  291.                     file to plain text.
  292.                o    The /UE command is used to export a score file in a
  293.                     format suitable for use with other database and spread-
  294.                     sheet programs.
  295.  
  296.  
  297.  
  298.  
  299.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 2
  300.  
  301.  
  302.      Q&A Study Aid V3.91 User's Guide
  303.  
  304.  
  305.           Recompiled Q&ASA using the large data model. In a system with
  306.           512K bytes of memory available after booting, Q&ASA can now
  307.           accomodate some 40,000 questions and their answers. Internal
  308.           overlays are used to keep the size of executable memory image to
  309.           a minimum.
  310.  
  311.           Q&ASA is now "DESQview aware" and will properly execute within a
  312.           DESQview window.
  313.  
  314.           Added a command to "shell" to DOS for access to an editor or
  315.           other program from within Q&ASA.
  316.  
  317.           The /FS (File/Save Database) command no longer causes an immedi-
  318.           ate exit to DOS. You may therefore save a database in progress
  319.           and then load another one.
  320.  
  321.      Version 3.80   August 4, 1990
  322.  
  323.           Changed Mode/Random from /MA to /MR.
  324.  
  325.           Eliminated the screen control menu.
  326.  
  327.           Left-justified the mode in the status window.
  328.  
  329.           Added a check to insure that the screen is free before updating
  330.           the time left.
  331.  
  332.           Recompiled with aggressive optimizations using the new version
  333.           (V6.0) of the Microsoft C Optimizing Compiler. The .EXE file size
  334.           has been significantly reduced.
  335.  
  336.      Version 3.70   December 30, 1989
  337.  
  338.           Fixed a major bug that caused all screen attributes to be set to
  339.           zero if the configuration file was missing. Since the configura-
  340.           tion file is not distributed with Q&A Study Aid, the effect was
  341.           to present a blank screen. Although commands could be entered and
  342.           the screen colors set, all of this had to be done with a blank
  343.           screen.
  344.  
  345.           Also fixed a bug in the answer screen that would not allow an
  346.           altered menu-select character to be used to escape into the menu
  347.           system. This bug was reported by a concerned user; our thanks go
  348.           out to him.
  349.  
  350.      Version 3.60   December 10, 1989
  351.  
  352.           A potential problem was found and corrected with the calculation
  353.           of weights. This problem would be encountered only if the total
  354.           weight exceeded 32767, which is the maximum weight permitted.
  355.  
  356.           The /FS (File/Save Database) and /FC (File/Continue Database)
  357.           commands were added. This combination allows the user of Q&ASA to
  358.  
  359.  
  360.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 3
  361.  
  362.  
  363.      Q&A Study Aid V3.91 User's Guide
  364.  
  365.  
  366.           save the current state of a test or quiz database and return to
  367.           it later. The database will be restored to its previous state.
  368.           These commands will not work if the database has a time limit
  369.           associated with it.
  370.  
  371.           The "E=" option has been added to the database compiler Q&AC.EXE.
  372.           This option specifies that the score file is to be encrypted so
  373.           that a user cannot complete a test or quiz, and then edit the
  374.           resulting score in the score file. A new utility, Q&AD.EXE,
  375.           restores the score file to plain ASCII text.
  376.  
  377.           A configuration file was added. This file must be located in the
  378.           same directory as the help file Q&ASA.HLP, and the same rules
  379.           that govern its access apply to the configuration file. The
  380.           configuration file is named Q&ASA.CFG. It is not included in the
  381.           distribution, since Q&ASA will automatically create it the first
  382.           time it is executed.
  383.  
  384.           A new command, /FE, allows the screen colors to be changed. The
  385.           new values are saved in the configuration file.
  386.  
  387.           A new command, /FM, allows the menu selector character to be
  388.           altered. This defaults to the forward slash character ('/'), but
  389.           may now be changed to any other character in the printable ASCII
  390.           range of '!' through '~', inclusive. Once changed, the new
  391.           selector character is saved in the configuration file so the
  392.           effect of the change will be permanent unless changed again.
  393.  
  394.           The weighting system was altered to permit questions to have a
  395.           weight of zero. If desired, all questions may be weighted as
  396.           zero, but this will cause all scores to be zero also.
  397.  
  398.      Version 3.50   August 10, 1989
  399.  
  400.           The menu was modified to eliminate the /FD and /FS commands,
  401.           which were replaced with the single command /FL (File/Load
  402.           Database). The directory defaults to the current working directo-
  403.           ry. The directory may be changed if desired.
  404.  
  405.           Major internal enhancements were made to the video system. Q&ASA
  406.           will now detect the type of display adapter in use, and will
  407.           operate properly with 132-column and 43- and 50-line modes. The
  408.           screen update rate has been increased. The /S? commands are
  409.           necessary only in extreme cases where snow is a severe problem
  410.           (these commands have been retained, however). Q&ASA will now
  411.           autoselect the screen update method.
  412.  
  413.           The registration functions have been entirely replaced. The new
  414.           registration system now sets the executable file to read-only to
  415.           prevent inadvertent overwriting of the executable image. The
  416.           serial number now provides certain essential information about
  417.           the system Q&ASA is running on. Q&ASA will detect certain changes
  418.           to itself and refuse to execute if it is modified. A demonstra-
  419.  
  420.  
  421.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 4
  422.  
  423.  
  424.      Q&A Study Aid V3.91 User's Guide
  425.  
  426.  
  427.           tion mode has been added (although the program is not distributed
  428.           as a demo; it is a full-featured program with no crippling of any
  429.           function).
  430.  
  431.           Q&ASA now intercepts the Control-C and Control-Break keys and
  432.           will perform a graceful exit with proper updating of the score
  433.           file. Hardware error detection and handling of critical errors
  434.           has been improved, and now offers the options of Retry or Cancel
  435.           (Cancel aborts only the command that experienced the error, not
  436.           the program as a whole).
  437.  
  438.           The Help key (F1) is now active in the opening screen. You may
  439.           obtain an overview of the operation of Q&ASA at the opening
  440.           screen, or exit the program by pressing ESCape. Several new
  441.           categories have been added to the help file for registering and
  442.           for reporting problems.
  443.  
  444.      Version 3.1    July 31, 1989
  445.  
  446.           Made some minor corrections and additions to this manual, and
  447.           corrected a minor bug related to locating the executable file on
  448.           disk.
  449.  
  450.      Version 3.0    May 1, 1989
  451.  
  452.           Corrected a bug in the random mode termination function, and
  453.           enhanced the random mode search speed. Version 2.1 would continue
  454.           to ask questions after they had been answered, allowing a user to
  455.           gain a score exceeding 100%. Also enhanced the registration func-
  456.           tion.
  457.  
  458.           o    Added the 'D=' command to Q&AC and Q&ASA to allow the data-
  459.                base author to disable display of the correct answer if the
  460.                user answers incorrectly.
  461.           o    Added the ability to specify and execute a database from the
  462.                DOS command line.
  463.  
  464.      Version 2.1    July 31, 1988
  465.  
  466.           Minor enhancements to help system.
  467.  
  468.      Version 2.0    March 22, 1988
  469.  
  470.           Major enhancements to allow Q&ASA to be used in a formal class-
  471.           room environment. Among the changes are the following:
  472.  
  473.           o    Optional logging of scoring information to a disk file.
  474.           o    Compiled database eliminates run-time interpreter errors and
  475.                permits the database to be encrypted.
  476.           o    Display of the database name as the window title.
  477.           o    Faster response when loading questions.
  478.           o    Greatly improved help system allows selection and viewing of
  479.                any help category at any time.
  480.  
  481.  
  482.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 5
  483.  
  484.  
  485.      Q&A Study Aid V3.91 User's Guide
  486.  
  487.  
  488.           o    Optional locking of selected mode and lockout of certain
  489.                commands.
  490.           o    Ability to assign a weight to each question and have this
  491.                weight determine the number of points awarded for a correct
  492.                answer to a question.
  493.           o    Ability to specify a time limit to answer all questions.
  494.           o    Elimination of all index files.
  495.  
  496.      Version 1.0    January 7, 1988
  497.  
  498.           Initial public release.
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 6
  544.  
  545.  
  546.      Q&A Study Aid V3.91 User's Guide
  547.  
  548.  
  549.      Introduction
  550.      ------------
  551.  
  552.      Q&ASA is a general-purpose program designed to present questions from
  553.      a database. The user is then prompted for an answer and graded accord-
  554.      ingly.
  555.  
  556.      In the context of this document, and within all program and other
  557.      files included with the Q&ASA package, the word 'database' is used in
  558.      its generic sense. For our purposes, a database is simply a collection
  559.      of questions, answers, and options that is created by the user,
  560.      compiled, and interpreted by the Q&ASA program. Like the more general
  561.      database programs such as dBASE(R), Q&A Study Aid uses an indexed
  562.      database, although the index is an integral part of the database
  563.      itself and not a separate file. All of the details of the database
  564.      implementation, such as the index, records, fields, and data types,
  565.      are handled automatically by the Q&A Study Aid package. You need not,
  566.      therefore, be concerned with these, or even know what they mean.
  567.  
  568.      Q&ASA provides two methods of reading the questions from the database:
  569.      sequential and random. The program starts up in sequential mode.
  570.  
  571.      A menu-driven command interface is provided with pull-down menus.
  572.      Filenames are selected from a directory by pointing. It is never
  573.      necessary to type in a filename unless a database is specified on the
  574.      command line.
  575.  
  576.      Q&ASA supports a comprehensive context-sensitive help system accessi-
  577.      ble via the F1 key. Help is provided by a single file, Q&ASA.HLP. This
  578.      file may be located in the current directory or in any directory
  579.      specified in the PATH environment variable. Q&ASA may therefore be
  580.      placed in the \bin (or equivalent) directory and accessed from any
  581.      other directory, provided that PATH environment variable includes
  582.      "\bin". If you place Q&ASA in a directory that is not in the PATH
  583.      string such that it is unable to locate its help file, Q&ASA will, as
  584.      a last resort, pop up a window and ask you to enter the name of
  585.      directory containing the help file. If you do not enter a directory
  586.      name (by pressing RETURN at the prompt), the Help key will be inac-
  587.      tive.
  588.  
  589.      Q&ASA uses a compiled database. The database compiler is included
  590.      within Q&ASA to allow you to create and compile your own databases.
  591.      The database compiler is invoked via the "Utilities" menu. Q&ASA.EXE
  592.      is written in the C language (with some assembly-language) and com-
  593.      piled using the Microsoft C Optimizing Compiler Version 6.00A and the
  594.      Microsoft Macro Assembler V6.0. RTLink/Plus is the overlay linker used
  595.      to generate the executable file.
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 7
  605.  
  606.  
  607.      Q&A Study Aid V3.91 User's Guide
  608.  
  609.  
  610.      This package contains the following files:
  611.  
  612.           Q&ASA.EXE      Q&ASA main program
  613.           Q&ASA.HLP      Q&ASA help file
  614.           Q&ASA.DOC      documentation file (this file)
  615.  
  616.           SAMPLE.Q&A     sample database (compiled)
  617.           SAMPLE.DEF     database definition file for SAMPLE.Q&A
  618.  
  619.      The Q&A Study Aid package is SHAREWARE and is copyrighted by the
  620.      author. If Q&ASA meets your needs and you continue to use the program,
  621.      you must register and pay for its use. The SHAREWARE concept allows
  622.      users to obtain high quality software at bargain prices, and rewards
  623.      authors for their efforts. Please support this distribution concept by
  624.      registering your copy. You will find a registration form at the back
  625.      of this manual (although the /UR command will doubtless be much more
  626.      convenient). You have unlimited rights to copy and distribute the
  627.      program, provided you distribute it as the complete UNMODIFIED package
  628.      Q&ASA391.ZIP (QASA391.ZIP on CompuServe). Comments, bug reports, or
  629.      other information that may help me improve this program are welcome
  630.      and are encouraged. Only you can tell me what you need!
  631.  
  632.      Q&ASA is offered as is. There is no guarantee that it will work on
  633.      your particular system; however, it has been tested with CGA, MDA,
  634.      EGA, and VGA monitors on PCs, ATs, 386 and 486 systems. Text mode is
  635.      used; no graphics card is needed. Q&ASA will NOT use an EMM if one is
  636.      present. A minimum of 134K of program space plus 28K of data space
  637.      (RAM) is needed by the program; it will tell you if you do not have
  638.      sufficient memory to execute it. Q&ASA will use all available memory
  639.      below the 640K conventional-memory boundary if it is required.
  640.  
  641.      All I/O is performed through system calls, with the exception of the
  642.      screen, which is controlled by direct writes to the screen buffer.
  643.      Under Microsoft(R) Windows, you must give Q&ASA control of the screen
  644.      in the Q&ASA.PIF file. Under DESQview, Q&ASA will multitask in a DESQ-
  645.      view window, and does not require any special system resources.
  646.  
  647.      Q&ASA assumes that your screen is set to any text mode (color or mono-
  648.      chrome). If not, it will NOT reset the mode. If your screen is in any
  649.      of the graphics modes when Q&ASA is invoked, you will see garbage.
  650.      Exit Q&ASA using the /FX command (or press ESC if you are still in the
  651.      opening screen) and reset the mode manually using the DOS MODE com-
  652.      mand. When Q&ASA terminates, it will restore the previous contents of
  653.      your screen.
  654.  
  655.  
  656.      Installation
  657.      ------------
  658.  
  659.      Q&A Study Aid requires no special installation other than that ex-
  660.      plained in the section entitled "A Special Note" below.
  661.  
  662.  
  663.  
  664.  
  665.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 8
  666.  
  667.  
  668.      Q&A Study Aid V3.91 User's Guide
  669.  
  670.  
  671.      The configuration file Q&ASA.CFG is not supplied with the distribution
  672.      package, since it is created automatically if it is missing. The first
  673.      time you execute Q&ASA, you will get a prompt asking you for the
  674.      directory containing the configuration file, since Q&ASA will not be
  675.      able to locate it on the disk. This prompt will appear anytime Q&ASA
  676.      is unable to find its configuration file. If you move the file, enter
  677.      the name of the directory containing the file; otherwise, press RETURN
  678.      without entering a directory to cause Q&ASA to create the file. You
  679.      will not be required to enter a directory if the configuration file is
  680.      stored in any directory in the PATH environment variable, or if it is
  681.      in the current directory.
  682.  
  683.      If you are using a hard disk, you may place the executable files in
  684.      any directory (note that the files Q&ASA.HLP and Q&ASA.CFG are consid-
  685.      ered to be part of the executable files). If you wish to execute the
  686.      program from a different directory than the one in which the files are
  687.      placed, you must include the directory containing the executable files
  688.      in the PATH environment variable. To view the PATH, issue the MS-DOS
  689.      command SET with no arguments; all environment variables will be
  690.      listed to the screen.
  691.  
  692.      If you do not have a PATH variable, as evidenced by a line of the form
  693.  
  694.      PATH=[list of directories]
  695.  
  696.      then you may enter one. If you have placed all executable files in the
  697.      directory C:\Q&ASA, for example, issue the command
  698.  
  699.           SET PATH=C:\Q&ASA <ENTER>
  700.  
  701.      Do not include any spaces after the word PATH. Also, it is unwise to
  702.      include any removable drive in the PATH, since DOS will attempt to
  703.      search the directory of that drive when you attempt to execute Q&ASA.
  704.      If the floppy has been removed, you will constantly get an error from
  705.      DOS.
  706.  
  707.      If you wish to append a new directory, C:\Q&ASA for example, to an
  708.      existing PATH, then simply retype your existing PATH and add the
  709.      directory to it as follows:
  710.  
  711.      You type:
  712.  
  713.           SET<ENTER>
  714.  
  715.      MS-DOS responds with (for example):
  716.  
  717.           PATH=C:\BIN
  718.           (other environment variables)
  719.  
  720.      You type:
  721.  
  722.           SET PATH=C:\BIN;C:\Q&ASA <ENTER>
  723.  
  724.  
  725.  
  726.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software     Page 9
  727.  
  728.  
  729.      Q&A Study Aid V3.91 User's Guide
  730.  
  731.  
  732.      Note the position of the semicolon - it is REQUIRED.
  733.  
  734.      Under DOS 3.30 and up, you may simplify this to:
  735.  
  736.           SET PATH=%PATH%;C\Q&ASA <ENTER>
  737.  
  738.      You should place the 'SET PATH=xxxx' command in your AUTOEXEC.BAT
  739.      file, so that it will be set automatically whenever your system is
  740.      booted.
  741.  
  742.      The Q&A Study Aid package is small enough to be placed on a single
  743.      5.25" 360KB diskette if desired. If your database is too large to fit
  744.      on one diskette, you may place it on a second diskette in the B: drive
  745.      if you have one. Because Q&ASA uses embedded overlays, you may not
  746.      remove the diskette that contains the Q&ASA.EXE file, as the prgram
  747.      will periodically read this file to load overlays.
  748.  
  749.      To create a database file, you need only a database definition file,
  750.      which you create, and the Q&ASA.EXE program. Similarly, once you have
  751.      created a database, the only files needed to execute the database are
  752.      the compiled database file (".Q&A"), Q&ASA.EXE, and Q&ASA.HLP. If
  753.      space is really at a premium, you may omit the help file Q&ASA.HLP,
  754.      but the HELP key (F1) will no longer function. If you do this, Q&ASA
  755.      will complain that it cannot find the help file, and ask you to enter
  756.      the directory in which it resides. To omit it, simply press ENTER
  757.      without entering a directory.
  758.  
  759.  
  760.      Compatibility
  761.      -------------
  762.  
  763.      The database files used by Q&ASA 3.91 are fully source-compatible with
  764.      all previous versions, but are not binary-compatible. All that is
  765.      required is that you recompile your database files with Version 3.91
  766.      of Q&ASA.
  767.  
  768.              Q&ASA WILL NOT WORK WITH THE HERCULES GRAPHICS ADAPTER.
  769.  
  770.  
  771.      A Special Note
  772.      --------------
  773.  
  774.      Special mention is made here of a particular characteristic of Q&ASA.
  775.      The program, to enforce its registration policies, will, at certain
  776.      times, modify its own executable image on disk. This is brought to
  777.      your attention as this behavior may trigger some virus-protection
  778.      programs. Please do not be concerned if this occurs; this is normal
  779.      behavior. You must allow Q&ASA to modify itself or it will not exe-
  780.      cute. Each time it is executed, Q&ASA will set itself to a read-only
  781.      file. The MS-DOS ATTRIB command may be used to alter this should you
  782.      desire to erase or move the program file. For example, you may copy
  783.      the program to a floppy diskette, then delete by issuing the following
  784.      DOS commands:
  785.  
  786.  
  787.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 10
  788.  
  789.  
  790.      Q&A Study Aid V3.91 User's Guide
  791.  
  792.  
  793.           ATTRIB -R Q&ASA.EXE
  794.           ERASE Q&ASA.EXE
  795.  
  796.      Q&ASA must be able to locate its own .EXE file. Under MS-DOS 3.0 and
  797.      above, you should experience no problems, even if you rename the file.
  798.      However, under MSDOS 2.x, if you rename the program, you must specify
  799.      the new program pathname using an environment variable. For example,
  800.      suppose Q&ASA.EXE is in the directory C:\BIN, and you rename it to
  801.      QUIZ.EXE. You must then issue the command
  802.  
  803.           SET Q&ASA=C:\BIN\QUIZ.EXE
  804.  
  805.      You may place this command in your AUTOEXEC.BAT file if you wish. You
  806.      MUST specify the COMPLETE pathname, including the .EXE extension. You
  807.      cannot, however, change the name of the help file Q&ASA.HLP. The
  808.      easist way to change the program name is to use a batch file. For
  809.      example, to change the name to QUIZ, create QUIZ.BAT as follows:
  810.  
  811.           COPY CON: QUIZ.BAT <ENTER>
  812.           Q&ASA %1 <ENTER>
  813.           ^Z <ENTER>                         (^Z means hold down Ctrl and
  814.                                              press 'Z')
  815.  
  816.      The '%1' will still enable you to specify the name of a database to
  817.      load automatically upon startup by typing:
  818.  
  819.           QUIZ sample
  820.  
  821.                                     IMPORTANT
  822.                                     ---------
  823.  
  824.      Q&ASA.EXE selects a serial number and combines this with certain
  825.      system information the FIRST time it is executed. This becomes your
  826.      serial number, and this number MUST be supplied to register the
  827.      program (the /UR command prints the registration form with the serial
  828.      number on it). ONCE THE SERIAL NUMBER HAS BEEN ASSIGNED BY Q&ASA, DO
  829.      NOT MODIFY OR OVERWRITE THE Q&ASA.EXE FILE OR YOUR REGISTRATION NUMBER
  830.      WILL NOT WORK. You may move the program by copying and then deleting
  831.      it as described above. If you accidentally overwrite a registered
  832.      program file, you will have to send for a new registration number, al-
  833.      though once you have paid the registration fee, new registration
  834.      numbers are supplied free of charge if they are needed. It is a good
  835.      idea to make a backup copy after you have executed it the first time,
  836.      and again after registering your copy. Once you have registered and
  837.      entered your registration number, the serial number will change; for
  838.      this reason, it is important that you include the most recent serial
  839.      number in all correspondence. This applies ONLY to the file Q&ASA.EXE;
  840.      all other files are standard data files.
  841.  
  842.      Q&ASA also requires that the time and date provided by the MS-DOS
  843.      operating system be correct, since it uses this information in the
  844.      score file. When Q&ASA is started, the current time and date are
  845.      checked; if either is invalid, Q&ASA will abort after displaying a
  846.  
  847.  
  848.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 11
  849.  
  850.  
  851.      Q&A Study Aid V3.91 User's Guide
  852.  
  853.  
  854.      message requesting you to set the system date and time to the proper
  855.      values.
  856.  
  857.      Q&ASA NEVER modifies any file other than its own executable image on
  858.      disk, the score file (if defined in the database), the saved database
  859.      file(s) (".SAV") if this feature is used, and the configuration file.
  860.      It will also create a ".Q&A" file each time you compile a new quiz,
  861.      and it will create a ".PRN" file is you export the score file. You
  862.      need not be concerned about modifications to your database source
  863.      files or any other files on your system.
  864.  
  865.  
  866.      User Interface
  867.      --------------
  868.  
  869.      Commands are entered into Q&ASA via a pull-down two-level menu system.
  870.      The uppermost screen region is the menu system. Each word group on the
  871.      menu line is the title block of a pull-down menu. Whenever one of the
  872.      titles is selected, the menu expands to display any options available
  873.      under it.
  874.  
  875.      Under most conditions, Q&ASA will be prompting for an answer to a
  876.      question. Some means must therefore be provided to break out and into
  877.      the menu system so that an option can be selected or a command given.
  878.      There are two ways of doing this: via an ALT key sequence or by
  879.      pressing the menu selector character, the forward slash ('/'). Note
  880.      that this character may be changed using the /UM (Utilities/Menu
  881.      Selector) command. This document will, however, assume that you have
  882.      NOT altered the default.
  883.  
  884.      If an ALT sequence is used, it is only necessary to press one or two
  885.      ALT keys to select any command option. A top-level selector is speci-
  886.      fied by ALT-shifting the highlighted letter. For example, the "Mode /
  887.      Sequential" command is executed with ALT-M/ALT-S. To do this, hold
  888.      down the ALT key and press 'M' and then 'S'.
  889.  
  890.      If you use the '/' menu selector character, the word MENU will first
  891.      appear at the right of the menu line to indicate that you are in the
  892.      menu system. At this point, any combination of highlighted and under-
  893.      scored letters (as defined by the screen colors you choose) and cursor
  894.      keys can be used to select a menu title block. Note that F1 will
  895.      always get help no matter where you may be, in or out of the menu
  896.      system. The only exception to this is for error messages ("Problem"),
  897.      for which you may not obtain help. Once the desired option has been
  898.      selected, RETURN executes it. Note that neither the slash nor the
  899.      RETURN are necessary when using ALT-key sequences.
  900.  
  901.      Versions 3.0 of Q&ASA and above provide the ability for you to specify
  902.      a database file on the command line. If you do so, you will still see
  903.      the opening screen, but as soon as you press a key, the database will
  904.      be loaded and the first question will be displayed. If the database
  905.      specifies a time limit, the timer will be started immediately.
  906.  
  907.  
  908.  
  909.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 12
  910.  
  911.  
  912.      Q&A Study Aid V3.91 User's Guide
  913.  
  914.  
  915.      If the database you specify cannot be found, then an error message
  916.      will be displayed, and you must select the database normally using the
  917.      /FL command. For example, the DOS command
  918.  
  919.           C>Q&ASA sample
  920.  
  921.      will load the sample database and display the first question. Note
  922.      that you do not have to specify the ".Q&A" extension. If you do
  923.      specify an extension, it MUST be ".Q&A"; Q&ASA will force this exten-
  924.      sion for all database files.
  925.  
  926.      Q&ASA's menu system commands are listed on the following page.
  927.  
  928.  
  929.      Q&ASA Command List
  930.      ------------------
  931.  
  932.           /FL       load a database
  933.           /FS       save a database for later resumption
  934.           /FC       continue with a previously-saved database
  935.           /FD       shell to DOS
  936.           /FX       exit to DOS
  937.  
  938.           /MS       set mode to sequential
  939.           /MR       set mode to pseudorandom
  940.           /MC       clear score and start quiz over
  941.  
  942.           /N        enter name
  943.  
  944.           /US       set screen colors
  945.           /UM       set menu selector character
  946.           /UP       set password
  947.           /UC       invoke database compiler
  948.           /UD       decrypt a score file to plain text
  949.           /UE       export a score file
  950.           /UR       print registration form (works only if the program copy
  951.                     is unregistered)
  952.  
  953.  
  954.      The Command Line
  955.      ----------------
  956.  
  957.      Q&ASA does not require any command-line parameters or arguments. It
  958.      will, however, allow you to specify the name of a database file on the
  959.      command line so that the program may be invoked from a batch file.
  960.  
  961.      If you specify the name of a database file on the command line, you do
  962.      not have to enter the extension. Q&ASA will change the extension as
  963.      required, and add one if it is omitted. For example, to start Q&ASA
  964.      using the sample database provided, you simply type
  965.  
  966.           Q&ASA SAMPLE <ENTER>
  967.  
  968.  
  969.  
  970.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 13
  971.  
  972.  
  973.      Q&A Study Aid V3.91 User's Guide
  974.  
  975.  
  976.      The opening screen will be displayed normally, but once you press
  977.      ENTER, the database file SAMPLE will be automatically loaded.
  978.  
  979.  
  980.      /FL - Load A Database
  981.      ---------------------
  982.  
  983.      When you issue this command, Q&ASA will display the name of the
  984.      directory you started Q&ASA from; e.g., the current working directory.
  985.      If your database files are located in this directory, simply press
  986.      RETURN to accept the default name. If your database files are located
  987.      in another directory, you may edit the directory name. Q&ASA will
  988.      remember the new directory name and present it as the default the next
  989.      time you use this command.
  990.  
  991.      When specifying the directory, you may select a different disk drive
  992.      followed by the path name to the database files in conventional DOS
  993.      form:
  994.  
  995.           D:\DIR\DIR.....
  996.  
  997.      If you clear the name of the directory by using the backspace key or
  998.      by using the HOME key followed by Ctrl-End, Q&ASA will automatically
  999.      insert the name of the current working directory after you press
  1000.      RETURN. Note that you will not see this occur as the window will be
  1001.      closed as soon as you press RETURN. However, the directory shown the
  1002.      next time you invoke the /FL command will be the current working
  1003.      directory again.
  1004.  
  1005.      If you enter a drive or directory that does not exist, you will
  1006.      receive an error message and you must enter the command again to
  1007.      specify the proper directory. If you enter the drive identifier of a
  1008.      floppy disk drive, and the drive door is open, you will receive an
  1009.      error, and you will be given the opportunity to close the drive door
  1010.      and retry the command.
  1011.  
  1012.      Note:     Certain DOS configurations can cause apparent errors that
  1013.                Q&ASA cannot detect. If, for example, you have installed a
  1014.                'foreign' disk drive using "DEVICE=DRIVER.SYS <parameters>"
  1015.                and reassigned the name of a diskette drive using the DRIV-
  1016.                PARM command in your CONFIG.SYS file (MS-DOS and PC-DOS 3.30
  1017.                and later only), and you enter the original drive letter,
  1018.                Q&ASA will appear to hang. Actually, what is happening is
  1019.                that DOS wants you insert the diskette for the drive you
  1020.                have reassigned it to, although you will not see the message
  1021.                DOS normally displays. All that is necessary is for you to
  1022.                press the RETURN key.
  1023.  
  1024.      Once you have entered the name of the directory containing your Q&ASA
  1025.      database files, Q&ASA will pop up a window to allow you to select from
  1026.      the compiled database files available in that directory. If there are
  1027.      no database files in the directory, Q&ASA will display "[ empty ]".
  1028.      Q&ASA will NOT display any files other than compiled database files.
  1029.  
  1030.  
  1031.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 14
  1032.  
  1033.  
  1034.      Q&A Study Aid V3.91 User's Guide
  1035.  
  1036.  
  1037.      To select a compiled database file, move the selection bar to it using
  1038.      the cursor keys, PgUp and PgDn, or Home and End. Each of these permits
  1039.      traveling up and down the scrollable list in larger increments.
  1040.      Alternatively, you may also press a letter key that corresponds to the
  1041.      first character of the database filename; Q&ASA will find the first
  1042.      file beginning with that letter. Successive depressions of the same
  1043.      key will step to each database name that begins with that letter. The
  1044.      search stops at the last file that begins with that letter. The search
  1045.      always proceeds down the list; to restart the search, press HOME to
  1046.      move the selector back to the first file in the list.
  1047.  
  1048.      Once you have pointed to the file you desire, press RETURN. The
  1049.      compiled database file will be loaded. If the optional score logging
  1050.      has been enabled in the database, Q&ASA will request that you enter
  1051.      your name for the score file (you may not proceed until you have done
  1052.      so, although you may abort the command at this point by pressing ESC).
  1053.      The first question will then appear on the screen, along with the
  1054.      number of questions in the database in the scoring window. The name of
  1055.      the database will also be shown in the center of the top border of the
  1056.      question window if it has been specified in the database. If no title
  1057.      was specified, then the window title will default to "Question".
  1058.  
  1059.      Note:     When you load a database file that specifies a score file
  1060.                name, and that score file already exists, Q&ASA will check
  1061.                to insure that the encryption modes are compatible. If not,
  1062.                it will display an error message and override the encryption
  1063.                setting in the database file you loaded.
  1064.  
  1065.                For example, if you create two separate databases, both of
  1066.                which specify the same name for the score file, but only one
  1067.                has score file encryption enabled, you will receive an error
  1068.                when you load the second database, no matter which one you
  1069.                load first. The order will affect only the encryption of the
  1070.                score file, which is determined by the first database load-
  1071.                ed. If you always use a different score file for each data-
  1072.                base, or are consistent with score file encryption, you
  1073.                should experience no problems. Note that Q&ASA will still
  1074.                function properly, however.
  1075.  
  1076.      Each time you load a database file with score file logging enabled,
  1077.      Q&ASA will request your name, even if you have already entered it.
  1078.      This is to allow other users to reload the same database without using
  1079.      the same name for all users. If score file logging is not enabled,
  1080.      Q&ASA doesn't force you to enter your name. You may do this anyway if
  1081.      you wish, using the /N (Name) command, and Q&ASA will politely display
  1082.      it when it displays your final score.
  1083.  
  1084.      If the database you load has a time limit associated with it, the time
  1085.      remaining will be displayed in the status window under the heading
  1086.      'Time Left', and the clock will start. The time is counted down to
  1087.      zero, and always shows the time you have remaining before Q&ASA stops
  1088.      you and calculates your final score. If the database does not specify
  1089.  
  1090.  
  1091.  
  1092.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 15
  1093.  
  1094.  
  1095.      Q&A Study Aid V3.91 User's Guide
  1096.  
  1097.  
  1098.      a time limit, the 'Time Left' field will not be displayed. If you
  1099.      allow the time to count down to zero, it will change to 'Time Out'.
  1100.  
  1101.      Note:     If you press the help key while a timed database is loaded,
  1102.                the time display will not be updated until you exit the help
  1103.                system. Q&ASA will, however, internally track the remaining
  1104.                time. You may NOT extend the time by using help.
  1105.  
  1106.      To permit Q&ASA to utilize relatively large databases (~40,000 ques-
  1107.      tions and their answers), Q&ASA loads an index into memory rather than
  1108.      the database file itself. The database index is created by Q&ASA in
  1109.      the form of a header in the database file itself. Note that this is
  1110.      true of the help file also to minimize the memory used by Q&ASA.
  1111.  
  1112.      The database file (.Q&A) should never be changed directly, as it is
  1113.      encrypted to prevent users from copying the file to the screen or a
  1114.      printer and thereby viewing the answers. If you wish to create a new
  1115.      database or alter an existing one, you must edit the database defini-
  1116.      tion file (.DEF) and recompile it using Q&ASA. Q&ASA will create a
  1117.      (.Q&A) file from your (.DEF) file. Q&ASA will not permit you to use
  1118.      the .Q&A extension on a definition file, so you cannot accidentally
  1119.      overwrite a compiled database.
  1120.  
  1121.      You must create the database definition file and compile it before
  1122.      Q&ASA can be used. Instructions for doing this are in a later section
  1123.      of this guide. Note that this package contains a compiled database
  1124.      that you may use to test and evaluate Q&ASA. This file is called
  1125.      SAMPLE.Q&A. The database definition file it was created from is also
  1126.      included, and is called SAMPLE.DEF.
  1127.  
  1128.  
  1129.      /FS - Save a Database
  1130.      ---------------------
  1131.  
  1132.      This command will save the present state of a database so that you may
  1133.      return and continue with it later. IT WILL NOT WORK IF THE DATABASE
  1134.      HAS A TIME LIMIT ASSOCIATED WITH IT.
  1135.  
  1136.      If you issue this command on a database that has no time limit, the
  1137.      state of the database will be saved in a file in the current directory
  1138.      with the same base name as the database, but with an extension of
  1139.      ".SAV". You may have different .SAV files in different directories for
  1140.      the same database if you wish.
  1141.  
  1142.      Note:     If you issue this command or the /FL (File/Load Database)
  1143.                command, any existing .SAV file for that database will be
  1144.                erased from the current working directory of the disk, and
  1145.                you will not be able to resume it. The /FL command, by
  1146.                definition, specifies that you wish to restart the database
  1147.                from the beginning.
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 16
  1154.  
  1155.  
  1156.      Q&A Study Aid V3.91 User's Guide
  1157.  
  1158.  
  1159.      Once you issue the /FS command, the database will be saved and you
  1160.      will be returned to the main screen so that you may execute another
  1161.      command.
  1162.  
  1163.  
  1164.      /FC - Continue with a Saved Database
  1165.      ------------------------------------
  1166.  
  1167.      This command will allow you to resume a database which was previously
  1168.      saved using the /FS (File/Save Database) command. It works exactly
  1169.      like the /FL (File/Load) command, except that the list of files
  1170.      displayed will have an extension of ".SAV" instead of ".Q&A". If no
  1171.      database file has been saved, "[ empty ]" will be displayed.
  1172.  
  1173.      When this command is used, the previous state of the database is
  1174.      restored. The question that was on the screen will be redisplayed, and
  1175.      the scoring window will reflect the previous state of the database.
  1176.  
  1177.      Note that once you have completed a quiz or test database, any .SAV
  1178.      file in the directory from which the database was originally loaded
  1179.      will be erased. You cannot, therefore, resume a completed database.
  1180.  
  1181.  
  1182.      /FD - Shell To DOS
  1183.      ------------------
  1184.  
  1185.      This command may be used to invoke a secondary copy of the DOS command
  1186.      processor COMMAND.COM (or whatever file is specified by the "SHELL="
  1187.      environment variable). Q&ASA will remain loaded. Note that this
  1188.      command will NOT work if a database is currently load (you will
  1189.      receive an error message).
  1190.  
  1191.      Once DOS has been invoked, you may execute any commands you wish,
  1192.      although you will have less memory available. When you wish to return
  1193.      to Q&ASA, type 'EXIT' and the DOS prompt. The previous state of Q&ASA
  1194.      will be restored to the screen.
  1195.  
  1196.  
  1197.      /FX - Exit to DOS
  1198.      -----------------
  1199.  
  1200.      Use this command to quit a Q&ASA session and return to DOS. If you
  1201.      have loaded a database but have not answered all questions, the score
  1202.      file will be updated with your current score and a notation that you
  1203.      quit Q&ASA. You cannot exit Q&ASA, clear the database, or reload the
  1204.      current or new database without updating your score file. This pre-
  1205.      vents extending time limits and/or starting a quiz over again without
  1206.      any knowledge by the administrator that such an event occurred.
  1207.  
  1208.      Also, when you quit a Q&ASA session using this command, any saved
  1209.      database file of the same name is erased from disk, preventing resump-
  1210.      tion if the database had been previously saved. As a general rule,
  1211.      whenever your final score is displayed (and optionally, the score file
  1212.  
  1213.  
  1214.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 17
  1215.  
  1216.  
  1217.      Q&A Study Aid V3.91 User's Guide
  1218.  
  1219.  
  1220.      is updated), or whenever you load a database using the /FL (File/Load
  1221.      Database) command, any associated .SAV file will be erased.
  1222.  
  1223.      Note:     Pressing Control-C or Control-Break is interpreted the same
  1224.                as /FX without the RETURN. Simply press RETURN to update the
  1225.                score file and return to DOS.
  1226.  
  1227.  
  1228.      /MS - Sequential Mode
  1229.      ---------------------
  1230.  
  1231.      The sequential mode option tells Q&ASA that you wish to answer the
  1232.      questions in the same order as they appear in the database file (this
  1233.      is the default). When selected, the new mode will appear in the
  1234.      scoring window. This option does NOT cause Q&ASA to start reading from
  1235.      the beginning of the file; it simply changes the method used to
  1236.      determine the next question. Sequential mode reads the questions from
  1237.      the database in a circular fashion until all questions have been
  1238.      answered. This allows switching between modes. Q&ASA will not present
  1239.      a question again once it has been answered.
  1240.  
  1241.      When all questions have been answered, Q&ASA will update the optional
  1242.      score file and display the final score.
  1243.  
  1244.      Note that this command may be locked out by an option given in the
  1245.      database definition file. If this is the case, the command will simply
  1246.      be ignored. No warning will be given indicating that the command is
  1247.      locked out.
  1248.  
  1249.  
  1250.      /MR - Pseudorandom Mode
  1251.      -----------------------
  1252.  
  1253.      This mode is used when you want Q&ASA to choose the questions at
  1254.      random. The pseudorandom number sequence is different each time the
  1255.      program is run.
  1256.  
  1257.      In this mode, Q&ASA will select the next question at random from the
  1258.      set of unanswered questions. It will not, therefore, ask a question
  1259.      again once it has been answered.
  1260.  
  1261.      When all questions have been answered, Q&ASA will update the optional
  1262.      score file and display the final score.
  1263.  
  1264.      Note that this command may be locked out by an option given in the
  1265.      database definition file. If this is the case, the command will simply
  1266.      be ignored. No warning will be given indicating that the command is
  1267.      locked out.
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 18
  1276.  
  1277.  
  1278.      Q&A Study Aid V3.91 User's Guide
  1279.  
  1280.  
  1281.      /MC - Clear
  1282.      -----------
  1283.  
  1284.      Use the Clear option to reset your score back to zero and to reset the
  1285.      question index back to the beginning of the file. The question index
  1286.      is cleared only by using this command or by loading a new database. If
  1287.      you use this command, a record will be written to the score file
  1288.      indicating that the database was started over.
  1289.  
  1290.      Note that this command may be locked out by an option given in the
  1291.      database definition file. If this is the case, the command will simply
  1292.      be ignored. No warning will be given indicating that the command is
  1293.      locked out.
  1294.  
  1295.  
  1296.      /N - Name
  1297.      ---------
  1298.  
  1299.      This command is used to enter your name, which is placed into the
  1300.      score file and also displayed when the quiz session is completed or
  1301.      otherwise terminated.
  1302.  
  1303.      When this command is given, a data entry window will pop up and prompt
  1304.      for your name and/or any other identifying information. You may enter
  1305.      up to 35 characters.
  1306.  
  1307.      If a database is loaded that specifies a score file, this command will
  1308.      not work. In this case, you will be prompted to enter your name when
  1309.      the database is loaded; you may not change it until the database has
  1310.      been completed or aborted.
  1311.  
  1312.  
  1313.      /US - Set Screen Colors
  1314.      -----------------------
  1315.  
  1316.      This command is used to modify the screen colors. A color map of all
  1317.      possible color is displayed, along with a simulated menu window. A
  1318.      title bar at the top of the screen specifies which portion of the
  1319.      screen you are modifying. All color selections are performed by using
  1320.      the cursor keys to point to the desired color. The PgUp and PgDn keys
  1321.      are used to alter the title bar, thereby changing the item whose color
  1322.      is to be modified. The simulated menu will change with each color
  1323.      change so that you may see the effect of the changes.
  1324.  
  1325.      Once you have set the colors as you wish, press ENTER to save the new
  1326.      colors in the configuration file, or ESCape to cancel the changes. For
  1327.      the full effect of the changes to be seen, you must quit Q&ASA and
  1328.      then restart it so that it will redraw all screens using the new color
  1329.      set.
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 19
  1337.  
  1338.  
  1339.      Q&A Study Aid V3.91 User's Guide
  1340.  
  1341.  
  1342.      /UM - Set Menu Selector Character
  1343.      ---------------------------------
  1344.  
  1345.      Q&ASA uses one character to escape (out of an answer prompt if dis-
  1346.      played) and into the menu system. This character defaults to the
  1347.      forward slash ('/'), but you may change it to any character you wish
  1348.      in the printable ASCII range of '!' through '~', inclusive. Once you
  1349.      change it, it is saved in the configuration file and will therefore be
  1350.      set each time you start Q&ASA. If you change your mind, you can reset
  1351.      the character or press ESCape to cancel the command if you have not
  1352.      yet pressed the ENTER key. The current menu selector character is
  1353.      always displayed at the bottom of the question/answer window.
  1354.  
  1355.  
  1356.      /UP - Set Password
  1357.      ------------------
  1358.  
  1359.      This command is used to set or change the password that allows access
  1360.      to the compiler, score file decoder, and the score file export com-
  1361.      mands.
  1362.  
  1363.      Q&ASA is distributed with no password. Anyone may therefore use the
  1364.      password-protected commands until and unless a password is entered
  1365.      using this command.
  1366.  
  1367.      When this command is selected, if there is a password, you will be
  1368.      asked to enter it. You cannot change a password unless you know the
  1369.      current password. The password may be any series of characters in the
  1370.      range of space through a tilde ('~'), inclusive, and may contain up to
  1371.      19 characters.
  1372.  
  1373.      If there is no current password, you will not be asked to enter it.
  1374.  
  1375.      Once you have entered the current password, if any, you will be asked
  1376.      to enter the new password. Once you have done this, you will be
  1377.      prompted to confirm it. If the two passwords match, the new password
  1378.      will be encrypted and stored. Any attempt to identify or modify the
  1379.      password will render Q&ASA useless; it will no longer execute.
  1380.  
  1381.      Note that once a valid password has been entered, Q&ASA is 'unlocked',
  1382.      and you will not be required to enter the password again for any
  1383.      function.
  1384.  
  1385.  
  1386.      /UC - Invoke Q&ASA Compiler
  1387.      ---------------------------
  1388.  
  1389.      This command is used to compile a database definition file into a
  1390.      compiled database file that may be executed by Q&ASA. This command is
  1391.      password-protected, and cannot be executed while a database is loaded
  1392.      even if you know the password.
  1393.  
  1394.  
  1395.  
  1396.  
  1397.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 20
  1398.  
  1399.  
  1400.      Q&A Study Aid V3.91 User's Guide
  1401.  
  1402.  
  1403.      See the section entitled "Using the Q&ASA Compiler" on page 30 for a
  1404.      full explanation on invoking and using the compiler.
  1405.  
  1406.  
  1407.      /UD - Decrypt Score File
  1408.      ------------------------
  1409.  
  1410.      This command is used to decrypt a score file. It is password-protect-
  1411.      ed.
  1412.  
  1413.      It will pop up a directory window so that you may enter the directory
  1414.      containing the score file to decrypt, or you may accept the directory
  1415.      shown by pressing ENTER. Once you have selected the directory, a file-
  1416.      selection window will be displayed so that you may select the score
  1417.      file to decrypt.
  1418.      Once you select a score file, the file will be converted to plain
  1419.      ASCII text. If the file is not encrypted, you will receive an error
  1420.      message.
  1421.  
  1422.      The decrypted score file replaces the original file. All score files
  1423.      are named using the base score file name defined in the database
  1424.      definition file, with an extension of ".SCR".
  1425.  
  1426.  
  1427.      /UE - Export Score File
  1428.      -----------------------
  1429.  
  1430.      This command is used to export the contents of certain fields in the
  1431.      score file to a file whose format is acceptable to the vast majority
  1432.      of database and spreadsheet programs. This command is password-pro-
  1433.      tected.
  1434.  
  1435.      By using this command, you may import all scores for an entire class
  1436.      into a spreadsheet, for example, and use the spreadsheet to calculate
  1437.      bell curves, normalize the scores or convert them to another form. You
  1438.      could average the scores for several Q&ASA quiz sessions. You may also
  1439.      use a database program to maintain a history by student of all quizzes
  1440.      and their scores.
  1441.  
  1442.      This command will pop up a directory window so that you may enter the
  1443.      directory containing the score file to export, or you may accept the
  1444.      directory shown by pressing ENTER. Once you have selected the directo-
  1445.      ry, a file-selection window will be displayed so that you may select
  1446.      the score file to export.
  1447.  
  1448.      Once you select a file, Q&ASA will check if the score file is encrypt-
  1449.      ed, and if so, will ask if you wish to decrypt it first. An encrypted
  1450.      score file may not be exported. If you answer NO, then the command is
  1451.      aborted.
  1452.  
  1453.      Q&ASA will then locate and export certain fields in the score file,
  1454.      creating one line for each record in the score file, as follows:
  1455.  
  1456.  
  1457.  
  1458.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 21
  1459.  
  1460.  
  1461.      Q&A Study Aid V3.91 User's Guide
  1462.  
  1463.  
  1464.           Student, Database, Score, Grade, Termination, Time
  1465.  
  1466.           where:
  1467.  
  1468.                Student        is the student's name in quotes
  1469.                Database       is the name of the database in quotes
  1470.                Score          is the final score
  1471.                Grade          is the letter grade in quotes
  1472.                Termination    is the termination explanation in quotes
  1473.                Time           is the the elapsed time in seconds
  1474.  
  1475.      Note that Q&ASA will also export a header line, which you may delete
  1476.      from the spreadsheet or database if you wish. The following is an
  1477.      example of an exported score file containg two records.
  1478.  
  1479.  
  1480.           "Student", "Database", "Score", "Grade", "Termination", "Time"
  1481.           "John Public", "History Quiz", 79.23, "C+", "Time Out", 720
  1482.           "Jane Doe", "Math Quiz", 94.00, "A", "Completed", 298
  1483.  
  1484.      If you are exporting the score file for use with Lotus(r) 1-2-3, you
  1485.      would use the /FI (File/Import) command. Be sure to select the "Num-
  1486.      bers" option.
  1487.  
  1488.  
  1489.      /UR - Print Registration Form
  1490.      -----------------------------
  1491.  
  1492.      This command will print a registration form to make as easy as possi-
  1493.      ble for you to register your copy of Q&A Study Aid.
  1494.  
  1495.      You may print the form to any device or any file. The device must be
  1496.      able to interpret carriage return, line feed, backspace, form feed,
  1497.      and normal text.
  1498.  
  1499.      The registration form will prompt your for the necessary information.
  1500.      In addition, it will determine a number of items concerning your
  1501.      system configuration. If any of the configuration items is incorrect,
  1502.      please make the necessary corrections. For example, Q&ASA will not
  1503.      detect an LCD screen - only color or monochrome.
  1504.  
  1505.      This form will display the registration price schedule and calculate
  1506.      the registration fee based upon the number of copies you wish to
  1507.      register.
  1508.  
  1509.      Scoring Window
  1510.      --------------
  1511.  
  1512.      The scoring window always shows the current state of both you and
  1513.      Q&ASA. The scoring window is blank until a database is loaded, so you
  1514.      may easily ascertain if a database is loaded or not. The items that
  1515.      may appear in the scoring window are described below.
  1516.  
  1517.  
  1518.  
  1519.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 22
  1520.  
  1521.  
  1522.      Q&A Study Aid V3.91 User's Guide
  1523.  
  1524.  
  1525.           Time Left      This shows the time remaining to answer all ques-
  1526.                          tions in a database that has a time limit. If the
  1527.                          database does not have a time limit, this field
  1528.                          will not be displayed. If the database has a time
  1529.                          limit associated with it, you will see this time
  1530.                          counting down to zero. At zero, it will change to
  1531.                          'Time Out'.
  1532.  
  1533.           Mode           This is the current question-indexing mode, and
  1534.                          will be "Random" or "Sequential". Q&ASA always
  1535.                          starts up in sequential mode. The mode may be
  1536.                          specified in the database.
  1537.  
  1538.           Questions      This specifies the total number of questions in
  1539.                          the database.
  1540.  
  1541.           Answered       This indicates the number of questions that you
  1542.                          have answered. When it equals the number of ques-
  1543.                          tions in the database, your final score will be
  1544.                          displayed.
  1545.  
  1546.           Correct        This is the number of questions that you have
  1547.                          answered correctly.
  1548.  
  1549.           Score          Your score is a simple ratio of the number of
  1550.                          possible points to the number you have been award-
  1551.                          ed, and is displayed in percent.
  1552.  
  1553.           Grade          If optional letter-grade equivalencies have been
  1554.                          assigned in the database, and the grade display
  1555.                          has not been turned OFF, then this will show the
  1556.                          current grade that has been achieved relative to
  1557.                          the score. The database may be configured so that
  1558.                          the grade is not displayed at all until a certain
  1559.                          score has been achieved; once this base score is
  1560.                          achieved, the grade will be updated along with the
  1561.                          score. If the grade display has been turned off,
  1562.                          or if there are no grade equivalencies in the
  1563.                          database, then this field will not be shown.
  1564.  
  1565.  
  1566.      Answering Questions
  1567.      -------------------
  1568.  
  1569.      Q&ASA does not require you to answer questions in the order Q&ASA
  1570.      presents them (as defined by the mode). Q&ASA will determine the next
  1571.      question using the mode you select, but once the question is dis-
  1572.      played, you may elect to skip it (intending to come back to it later)
  1573.      and let Q&ASA present the next one. Q&ASA will remember that the
  1574.      question was skipped and display it again at some later time, depend-
  1575.      ing upon the mode you have selected.
  1576.  
  1577.  
  1578.  
  1579.  
  1580.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 23
  1581.  
  1582.  
  1583.      Q&A Study Aid V3.91 User's Guide
  1584.  
  1585.  
  1586.      Skipping a question is done simply by pressing the ESCape key when
  1587.      Q&ASA prompts for an answer. The question will not be scored, but
  1588.      Q&ASA will present it again after you have answered all of the remain-
  1589.      ing questions (sequential mode) or at any time (random mode). You may
  1590.      not omit a question, but you may essentially scan through the ques-
  1591.      tions and answer them in the order you choose.
  1592.  
  1593.      If you choose to answer a question, you must enter a response. Q&ASA
  1594.      will not accept a blank answer.
  1595.  
  1596.      Q&ASA will always display the number of points you will be awarded if
  1597.      you answer correctly at the right of the answer window. The number of
  1598.      points displayed is the ratio of the total weight of all questions in
  1599.      the database to the weight of the question in points relative to 100%,
  1600.      as defined in the compiled database. If you answer incorrectly, you
  1601.      are awarded zero points.
  1602.  
  1603.      You may also enter a command any time you are being prompted for an
  1604.      answer.
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 24
  1642.  
  1643.  
  1644.      Q&A Study Aid V3.91 User's Guide
  1645.  
  1646.  
  1647.      Creating a Database
  1648.      -------------------
  1649.  
  1650.      The database is the heart of Q&ASA. Q&ASA receives virtually all of
  1651.      the information it needs to present and score your answers from the
  1652.      database.
  1653.  
  1654.      The database is created from a plain ASCII, or 'flat' file, and then
  1655.      compiled using the database compiler within Q&ASA. The input given to
  1656.      Q&ASA is called the database definition file; the output of Q&ASA is
  1657.      the compiled database. Q&ASA creates and destroys one intermediate
  1658.      file (with an extension of ".$$$") as it compiles the database defini-
  1659.      tion file.
  1660.  
  1661.      Q&ASA supports a large number of options that may be used to control
  1662.      the quiz session. Each option is specified using a keyword followed by
  1663.      zero or more lines of text. It is important to remember that keywords
  1664.      must be on a line by themselves with NO OTHER TEXT.
  1665.  
  1666.      If you use a word processor program to create the database definition
  1667.      file, be sure to use its 'nondocument' mode to insure that it won't
  1668.      put in any formatting codes. A plain ASCII text editor is recommended
  1669.      (EDLIN, which is included with DOS, is one such editor).
  1670.  
  1671.      To enable Q&ASA to handle all of the common question formats except
  1672.      'essay' questions, a very general database arrangement is used. Q&ASA
  1673.      expects each question to be followed by the correct answer, which it
  1674.      uses to check the answer typed in by the user.
  1675.  
  1676.      Q&ASA can handle multiple-choice, true/false, and fill-in-the-blank
  1677.      questions with equal ease.
  1678.  
  1679.      The database must contain one instance of each of two keywords for
  1680.      each question in the database. These keywords are, exactly, in quotes:
  1681.  
  1682.           "Q="
  1683.           "A="
  1684.  
  1685.      As you might expect, these stand for "question" and "answer". The
  1686.      question MUST precede the answer. Q&ASA will complain about any
  1687.      irregularities it finds in the database when it constructs the com-
  1688.      piled database file.
  1689.  
  1690.      The following is a simple example of a question and answer as they
  1691.      might appear in the database definition file. It is a multiple-choice
  1692.      question. The following text is entered into the database definition
  1693.      file:
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 25
  1703.  
  1704.  
  1705.      Q&A Study Aid V3.91 User's Guide
  1706.  
  1707.  
  1708.      Q=
  1709.      Multiple-choice:
  1710.  
  1711.      What is the capital of Pennsylvania?
  1712.      A. Philadelphia
  1713.      B. Washington, D.C.
  1714.      C. Harrisburg
  1715.      D. None of the above
  1716.  
  1717.      A=
  1718.      C
  1719.  
  1720.      Q&ASA will display the question beginning on the line immediately
  1721.      following the 'Q=' line. The end of the question is marked by the
  1722.      'A='. All lines between these markers form the question, which Q&ASA
  1723.      will display exactly as it appears in the database. You may, there-
  1724.      fore, format your questions any way that you wish. Q&ASA does abso-
  1725.      lutely no interpretation of the text you enter for a question. Q&ASA
  1726.      will impose NO restrictions other than the number of rows and columns;
  1727.      you may use up to 15 lines of 76 characters. If the question contains
  1728.      more than 15 lines, the extra lines will be discarded and you will
  1729.      receive an error message. Blank lines between the end of the actual
  1730.      question and the 'A=' line are effectively discarded and do not count
  1731.      against the 15 lines allowed. The question above, therefore, consists
  1732.      of seven lines, not eight.
  1733.  
  1734.      Note that the 'Multiple-choice' prompt is actually a part of the
  1735.      database - NOT hard-coded into Q&ASA. You may include this as part of
  1736.      your database or omit it if you wish.
  1737.  
  1738.      The answer follows beginning on the line immediately after the 'A='.
  1739.      In this example, it is 'C'. All this means is that Q&ASA will score as
  1740.      correct any response to the question that is exactly 'C' OR 'c' - case
  1741.      is insignificant. Q&ASA does some preformatting of these strings prior
  1742.      to the comparison, however. Both the answer in the database and the
  1743.      answer typed in when the database is executed are processed the same
  1744.      way:
  1745.  
  1746.           1.   All leading whitespace is removed. This means that
  1747.                     C
  1748.                and
  1749.                               C
  1750.                are equivalent and are themselves equivalent to the 'C' in
  1751.                the example above.
  1752.  
  1753.           2.   All trailing whitespace, including newline characters, is
  1754.                removed.
  1755.  
  1756.           3.   All whitespace (blanks and tabs) between words is collapsed
  1757.                to a single space;
  1758.                     "Washington, D.C."
  1759.                and
  1760.                     "Washington,        D.C."
  1761.  
  1762.  
  1763.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 26
  1764.  
  1765.  
  1766.      Q&A Study Aid V3.91 User's Guide
  1767.  
  1768.  
  1769.                are equivalent.
  1770.  
  1771.           4.   All characters are folded to uppercase; 'Yes' and 'yes' are
  1772.                therefore equivalent.
  1773.  
  1774.      These steps insure that a response will not be scored as incorrect due
  1775.      to the position or character case of any part of the response in
  1776.      either your answer or that in the database.
  1777.  
  1778.      Note that these same rules are also applied to the 'Q=' and 'A='
  1779.      markers. They may, therefore, appear anywhere on the line. You cannot,
  1780.      however, insert anything between 'Q' and '=', nor can you put anything
  1781.      else on the line with the marker.
  1782.  
  1783.      In the example above, one correct answer was specified. The only
  1784.      answer that could be scored as correct is 'C' (and 'c', of course).
  1785.      Note that we could just as well have used numbers as selectors and
  1786.      given '3' as the answer. Q&ASA makes no attempt to interpret this
  1787.      information; it simply looks for an exact match based on the criteria
  1788.      outlined above.
  1789.  
  1790.      This next example will demonstrate a true/false question.
  1791.  
  1792.      Q=
  1793.  
  1794.  
  1795.  
  1796.                Answer true or false:
  1797.  
  1798.                Q&ASA understands the information in the database.
  1799.                     A=
  1800.      False
  1801.  
  1802.      Note the (valid) position of the 'A='. This time we have indented the
  1803.      question using tabs. When Q&ASA compiles the question, it expands the
  1804.      tabs automatically (using 8-column tab stops) to maintain the align-
  1805.      ment as it is in the database definition file. We also have three
  1806.      blank lines after the 'Q='; this serves to shift the question down
  1807.      toward the center of the question window to make it look nicer.
  1808.  
  1809.      This example is not good practice (although it will be compiled
  1810.      correctly), since the 'A=' would be easy to miss if the database were
  1811.      edited, and the indentation is inconsistent. It does, however, have a
  1812.      more serious drawback: to get the question right, you must type in
  1813.      'false' - all 5 characters - and 'false' is one word I just cannot
  1814.      type (it always comes out 'flase')!
  1815.  
  1816.      For a true/false question, one would be likely to respond with 'T',
  1817.      'F', 'yes', 'y', 'no', 'n', or possibly '1' and '0'. To accommodate
  1818.      these options, Q&ASA allows more than one correct answer. In fact,
  1819.      every nonblank line following 'A=' is treated as a correct answer. The
  1820.      second example above, then, would be more appropriately given by
  1821.  
  1822.  
  1823.  
  1824.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 27
  1825.  
  1826.  
  1827.      Q&A Study Aid V3.91 User's Guide
  1828.  
  1829.  
  1830.      Q=
  1831.  
  1832.  
  1833.  
  1834.                Answer true or false:
  1835.  
  1836.                Q&ASA understands the information in the database.
  1837.  
  1838.      A=
  1839.      False
  1840.      F
  1841.      No
  1842.      N
  1843.      0
  1844.  
  1845.      This permits any of the five answers to be regarded as correct.
  1846.  
  1847.      If you give an incorrect response to a question (e.g., one that is not
  1848.      among the list of correct answers), Q&ASA will display the correct
  1849.      answer for you, as well as omit one or more points from your score.
  1850.      When Q&ASA displays the correct answer, it uses the first one given in
  1851.      the answer list. What this means is that Q&ASA will display
  1852.  
  1853.  
  1854.                         Incorrect. The correct answer is
  1855.                                       False
  1856.                            Press any key to continue.
  1857.  
  1858.  
  1859.      which is more professional than 'N', for example.
  1860.  
  1861.      This feature adds a lot of versatility to Q&ASA. Since Q&ASA is
  1862.      intended to be a study aid as well as a general-purpose testing
  1863.      program, it provides reinforcement of incorrect answers by permitting
  1864.      a more complete correct answer. To demonstrate this, we'll use a third
  1865.      example; this time, a fill-in-the-blank question:
  1866.  
  1867.      Q=
  1868.           The speed of light is ______ km/sec.
  1869.  
  1870.      A=
  1871.           Light travels at 300,000 km/sec.
  1872.           300000
  1873.           300,000
  1874.           300K
  1875.  
  1876.      In this example, an incorrect response will elicit
  1877.  
  1878.                         Incorrect. The correct answer is
  1879.                         Light travels at 300,000 km/sec.
  1880.                            Press any key to continue.
  1881.  
  1882.  
  1883.  
  1884.  
  1885.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 28
  1886.  
  1887.  
  1888.      Q&A Study Aid V3.91 User's Guide
  1889.  
  1890.  
  1891.      Of course, this is also a correct answer in itself, but not a likely
  1892.      one. If you do enter it, it will be scored as correct. You would,
  1893.      however, be required to include the comma, the slash between 'km' and
  1894.      'sec', and the period.
  1895.  
  1896.      There are three more plausible correct answers that Q&ASA would
  1897.      consider to be correct. Any one of them is sufficient to credit the
  1898.      answer as correct.
  1899.  
  1900.      Note that the display of the correct answer may be disabled beginning
  1901.      with Version 3.0 of Q&ASA. This is done by issuing the 'D=' (Display
  1902.      Off) command in the database. This a global command and will turn off
  1903.      the display of all answers, no matter where you place the command in
  1904.      the database definition file.
  1905.  
  1906.      When creating a large database definition file, it is annoying to have
  1907.      to type the four or more common answers to a true/false question. To
  1908.      make this easier, Q&ASA supports simple macros. A macro is a block of
  1909.      text that is inserted in place of a macro identifier. We may therefore
  1910.      create a macro for 'true' and a macro for 'false', and use the macro
  1911.      identifier instead of typing all four answer lines. These macros would
  1912.      look something like the example on the following page.
  1913.  
  1914.  
  1915.      M=
  1916.           $TRUE$
  1917.           true
  1918.           t
  1919.           yes
  1920.           y
  1921.  
  1922.      M=
  1923.           $FALSE$
  1924.           false
  1925.           f
  1926.           no
  1927.           n
  1928.  
  1929.  
  1930.      Q=
  1931.  
  1932.                Answer true or false:
  1933.  
  1934.                Q&ASA understands the information in the database.
  1935.  
  1936.      A=
  1937.      $FALSE$
  1938.  
  1939.      The "M=" is the macro keyword, and tells Q&ASA that the following
  1940.      lines form a macro definition. The first line following the macro
  1941.      keyword is the macro identifier. You may use any character string as a
  1942.      macro identifier, provided it does not contain blanks or tabs. The
  1943.      dollar signs are not necessary, but serve nicely to identify $FALSE$
  1944.  
  1945.  
  1946.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 29
  1947.  
  1948.  
  1949.      Q&A Study Aid V3.91 User's Guide
  1950.  
  1951.  
  1952.      as a macro invocation. When Q&ASA reads the identifier, it will
  1953.      substitute all lines following the macro identifier up to the first
  1954.      blank line or keyword, whichever is found first. Note that Q&ASA will
  1955.      display "false" as the correct answer if the question is answered
  1956.      incorrectly, as it is the first answer in the answer list formed by
  1957.      expanding the macro.
  1958.  
  1959.      The above is a short introduction to creating a database definition
  1960.      file. The following section describes the Q&ASA compiler in detail.
  1961.  
  1962.  
  1963.      The Q&ASA Database Compiler
  1964.      ---------------------------
  1965.  
  1966.      The Q&ASA compiler is used only when a database is first created. A
  1967.      password (if entered using the /UP command) is required to gain access
  1968.      to it. Once the database definition file has been created, it is
  1969.      compiled with Q&ASA, and the compiled database file (which has an
  1970.      extension of .Q&A) is used with the Q&ASA program. This offers several
  1971.      advantages, among them:
  1972.  
  1973.           1.   The database is encrypted. A user of Q&ASA cannot look in
  1974.                the file using any viewing, listing, or debugging program
  1975.                and see the questions and answers. The Q&ASA interpreter
  1976.                knows the encryption method and decrypts the database as it
  1977.                reads it.
  1978.  
  1979.           2.   The author of the database definition file may specify a
  1980.                number of options to control the quiz session. These options
  1981.                cannot be seen or modified by anyone using Q&ASA.
  1982.  
  1983.           3.   Since the database has been preprocessed by Q&ASA, loading
  1984.                and display of questions is fast and error-free. It is not
  1985.                necessary for Q&ASA to perform any formatting at run time.
  1986.  
  1987.  
  1988.      Using The Q&ASA Compiler
  1989.      ------------------------
  1990.  
  1991.      When you issue the /UC command, Q&ASA will prompt for a password (if
  1992.      one has been defined), and will then display a window showing the
  1993.      current directory. If your database definition files are in another
  1994.      directory, you may edit the directory here using the standard DOS
  1995.      directory naming conventions. Once you accept the directory by press-
  1996.      ing ENTER, a file-selection window will be displayed, listing all of
  1997.      the database definition files in that directory (e.g., all files with
  1998.      an extension of ".DEF"). Q&ASA requires you to use an extension of
  1999.      ".DEF" for the database definition file. Select the file you wish to
  2000.      compile and press ENTER. Q&ASA will compile the database and then
  2001.      present a screen showing the results of the compilation.
  2002.  
  2003.      Q&ASA will not make any changes to the database definition file (your
  2004.      'source' file). It will create a compiled database file of the same
  2005.  
  2006.  
  2007.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 30
  2008.  
  2009.  
  2010.      Q&A Study Aid V3.91 User's Guide
  2011.  
  2012.  
  2013.      base name, but with an extension of .Q&A. If the database definition
  2014.      file is named QUIZ.DEF, then the compiled database will have a name of
  2015.      QUIZ.Q&A. If the compiled database file already exists, it is over-
  2016.      written by Q&ASA, and the original contents will be lost. Q&ASA will
  2017.      NOT warn you of this.
  2018.  
  2019.      When Q&ASA is finished, it will display the results of the compila-
  2020.      tion, including the options you selected in the definition file. The
  2021.      output below was produced by compiling the sample database SAMPLE.DEF
  2022.      (the screen window has been reduced horizontally to fit on the page).
  2023.  
  2024.  
  2025.      +----------------------- Compilation Results ------------------------+
  2026.      | Database Name:  Q&ASA Sample Database                              |
  2027.      | Input File:     C:\QPQ\V391\SAMPLE.DEF                             |
  2028.      | Output File:    C:\QPQ\V391\SAMPLE.Q&A                             |
  2029.      | Score Filename: SAMPLE.SCR               Total Weight:    35       |
  2030.      | Time Limit:     00:10:00                 Mode Lock:       (none)   |
  2031.      | Clear Command:  Enabled                  Answer Display:  Enabled  |
  2032.      | Source Lines:   496                      Total Questions: 25       |
  2033.      | Macro List:                              Letter Grades:   13       |
  2034.      | $TRUE$                                                             |
  2035.      | $FALSE$                                                            |
  2036.      |                                                                    |
  2037.      |                                                                    |
  2038.      |                                                                    |
  2039.      |                                                                    |
  2040.      |                                                                    |
  2041.      |                      Press Any Key To Continue                     |
  2042.      +--------------------------------------------------------------------+
  2043.  
  2044.  
  2045.      Q&ASA Language Syntax
  2046.      ---------------------
  2047.  
  2048.      Q&ASA, being a true compiler, requires that you follow certain syntac-
  2049.      tical rules when creating a database definition file. The syntax was
  2050.      made as simple and forgiving as possible to minimize the learning
  2051.      time.
  2052.  
  2053.      The Q&ASA language is line-oriented, meaning that Q&ASA views its
  2054.      input in terms of whole lines. You may not, therefore, put two keyword
  2055.      markers on the same line, for example.
  2056.  
  2057.      The following is a short summary of the keywords that Q&ASA uses.
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 31
  2069.  
  2070.  
  2071.      Q&A Study Aid V3.91 User's Guide
  2072.  
  2073.  
  2074.           Q=   Question text
  2075.           A=   Answer list
  2076.           P=   remove Punctuation from the next answer
  2077.           N=   quiz Name
  2078.           M=   Macro definition
  2079.           T=   Time limit
  2080.           C=   Clear not allowed
  2081.           S=   lock in Sequential mode
  2082.           R=   lock in Random mode
  2083.           F=   output score Filename
  2084.           E=   Encrypt score file
  2085.           W=   assign Weighting
  2086.           G=   assign letter-Grade equivalencies
  2087.           D=   disable Display of incorrect answers
  2088.  
  2089.      Each of these keywords is described in the following paragraphs.
  2090.  
  2091.      Q&ASA scans and discards all text in the database definition file that
  2092.      is not part of a keyword interpretation. This means that you may
  2093.      insert comments almost anywhere, without using special comment delim-
  2094.      iters or markers. Since Q&ASA is line-oriented, you may not, of
  2095.      course, place a comment on the same line with any keyword or its
  2096.      associated text. Comments are otherwise unrestricted. The sample
  2097.      database definition file SAMPLE.DEF provides many examples of the use
  2098.      of comments.
  2099.  
  2100.      Terminators
  2101.      -----------
  2102.  
  2103.      Every Q&ASA keyword (e.g., "Q=", "A=", etc.) has a termination, which
  2104.      tells the compiler when the end of the keyword interpretation has been
  2105.      reached. For all Q&ASA keywords, with the single exception of the Q=
  2106.      keyword, the termination is the same: a blank line, another keyword,
  2107.      or end-of-file. In this context, a blank line is any line that con-
  2108.      tains zero or more space or tab characters only. For the Q= keyword, a
  2109.      blank line is NOT a termination; only the 'A=' keyword terminates a
  2110.      question. This is to allow blank lines in the question text. You must
  2111.      be careful not to place comment lines between the Q= and A= keywords,
  2112.      since these will be regarded as part of the question and displayed on
  2113.      the Q&ASA screen.
  2114.  
  2115.  
  2116.      The Q= and A= Keywords
  2117.      ----------------------
  2118.  
  2119.      As mentioned previously, Q= and A= are the keywords for 'question' and
  2120.      'answer', respectively. The syntax is as follows:
  2121.  
  2122.           Q=
  2123.           <question text>
  2124.           <question text>
  2125.           <blank line(s)>
  2126.           ....
  2127.  
  2128.  
  2129.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 32
  2130.  
  2131.  
  2132.      Q&A Study Aid V3.91 User's Guide
  2133.  
  2134.  
  2135.           <question text>
  2136.           <blank line(s)>
  2137.           A=
  2138.           <displayed answer>
  2139.           ....
  2140.           <termination>
  2141.  
  2142.      A question may not have more than 15 lines of text associated with it,
  2143.      and you are limited to 76 characters per line. Within this rectangular
  2144.      boundary, you are unrestricted. If you exceed the allowed number of
  2145.      lines or if a line contains more than 76 characters (after tab and
  2146.      macro expansion), Q&ASA will display an error message.
  2147.  
  2148.      You are permitted any number of answer lines, limited only by the
  2149.      amount of memory available in the PC running Q&ASA. If the PC has 128K
  2150.      bytes or more of available memory (free memory above DOS and all
  2151.      TSRs), you are essentially unrestricted.
  2152.  
  2153.  
  2154.      The P= Keyword
  2155.      --------------
  2156.  
  2157.      This keyword is used to simplify the answer list for answers that
  2158.      contain unimportant punctuation. For example, if the correct answer to
  2159.      a question is "Washington, D.C.", you would not want a student scored
  2160.      as incorrect if he or she were to answer with "Washington DC". The P=
  2161.      keyword prevents this situation.
  2162.  
  2163.      The P= keyword applies ONLY to the next answer list following the
  2164.      keyword. Once the next answer is compiled, punctuation is once again
  2165.      significant.
  2166.  
  2167.      Also, the P= keyword causes punctuation to be stripped from all answer
  2168.      lines beginning with the SECOND answer line. This is so that the
  2169.      correct answer can be displayed with all punctuation intact if the
  2170.      question is answered incorrectly. To elaborate on the "Washington,
  2171.      D.C." example, you could use:
  2172.  
  2173.      P=
  2174.      Q=
  2175.      What is the capitol of the United States?
  2176.      A=
  2177.      Washington, D.C.
  2178.      Washington, D.C.
  2179.  
  2180.      Note that the FIRST answer line will be left intact, but all punctua-
  2181.      tion will be removed from the second line when it is compiled. Also,
  2182.      when the user enters an answer in response to the question, all
  2183.      punctuation will be removed from the answer before it is compared to
  2184.      the answer list. Therefore, any answer that contains "Washington DC"
  2185.      will be scored as correct: "Washington, DC", "Washington D.C.", and so
  2186.      on. It is NOT necessary to include the punctuation in the second
  2187.      answer line above.
  2188.  
  2189.  
  2190.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 33
  2191.  
  2192.  
  2193.      Q&A Study Aid V3.91 User's Guide
  2194.  
  2195.  
  2196.      This keyword is also useful for numbers; e.g., it removes any distinc-
  2197.      tion between "1,000" and "1000", and between "$50" and "50". In some
  2198.      cases you will have to exercise caution, as in "$50.00", where "5000"
  2199.      would be scored as correct, even though it is not at all what was
  2200.      intended.
  2201.  
  2202.  
  2203.      The N= Keyword
  2204.      --------------
  2205.  
  2206.      The N= keyword is used to specify the quiz name. The name must appear
  2207.      on the line following the keyword, and may be up to 60 characters in
  2208.      length. When the database is loaded into Q&ASA, this name appears in
  2209.      the top border of the center (question) window.
  2210.  
  2211.      For example, to name a quiz on American history as such, you would use
  2212.  
  2213.      N=
  2214.      American History Quiz
  2215.  
  2216.  
  2217.      The M= Keyword
  2218.      --------------
  2219.  
  2220.      The M= keyword is the macro definition keyword, and indicates to Q&ASA
  2221.      that the following lines are a macro definition. The macro definition
  2222.      takes the following form:
  2223.  
  2224.           M=
  2225.           <macro identifier>
  2226.           <first macro line>
  2227.           <second macro line>
  2228.           ..............
  2229.           <Nth macro line>
  2230.           <termination>
  2231.  
  2232.      Macros are expanded only within question and answer text, so you may
  2233.      not use a macro to specify a score file name, for example.
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 34
  2252.  
  2253.  
  2254.      Q&A Study Aid V3.91 User's Guide
  2255.  
  2256.  
  2257.      To build a macro for 'TRUE' from two other macros, you could use:
  2258.  
  2259.      M=
  2260.      $T$
  2261.      True
  2262.      T
  2263.      M=
  2264.      $Y$
  2265.      Yes
  2266.      Y
  2267.      M=
  2268.      $TRUE$
  2269.      $T$
  2270.      $Y$
  2271.  
  2272.      We have defined three macros, "$T$", "$Y$", and "$TRUE$". If Q&ASA
  2273.      encounters $TRUE$ in a question or answer, it will replace it with:
  2274.  
  2275.      True
  2276.      T
  2277.      Yes
  2278.      Y
  2279.  
  2280.      because "True" and "T" are expansions of $T$ and "Yes" and "Y" are
  2281.      expansions of $Y$. Note that blank lines are unnecessary between the
  2282.      macro definitions, since each is terminated by the M= keyword of the
  2283.      following macro.
  2284.  
  2285.      Macro invocations MUST be surrounded by whitespace. For example, many
  2286.      multiple-choice questions use the blanket selectors "none of the
  2287.      above" and "all of the above". You could therefore use the following
  2288.      macros:
  2289.  
  2290.      M=
  2291.      $NONE$
  2292.      None of the above.
  2293.      M=
  2294.      $ALL$
  2295.      All of the above.
  2296.  
  2297.      and write a multiple-choice question as:
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 35
  2313.  
  2314.  
  2315.      Q&A Study Aid V3.91 User's Guide
  2316.  
  2317.  
  2318.      Q=
  2319.      Multiple-choice:
  2320.  
  2321.      In what year did Christopher Columbus land in the New World?
  2322.  
  2323.           1. 1592
  2324.           2. 1492
  2325.           3. 1066
  2326.           4. $NONE$
  2327.           5. $ALL$
  2328.  
  2329.      A=
  2330.      2. 1492
  2331.      2
  2332.      1492
  2333.  
  2334.      Q&ASA will expand this to:
  2335.  
  2336.      Q=
  2337.      Multiple-choice:
  2338.  
  2339.      In what year did Christopher Columbus land in the New World?
  2340.  
  2341.           1. 1592
  2342.           2. 1492
  2343.           3. 1066
  2344.           4. None of the above.
  2345.           5. All of the above.
  2346.  
  2347.      A=
  2348.      2. 1492
  2349.      2
  2350.      1492
  2351.  
  2352.      Remember that the Q&ASA compiler is line-oriented, however. If you put
  2353.      the following in the database definition file:
  2354.  
  2355.      M=
  2356.      $NW$
  2357.      New World
  2358.  
  2359.      Q=
  2360.      Multiple-choice:
  2361.  
  2362.      In what year did Christopher Columbus land in the $NW$?
  2363.  
  2364.           1. 1592
  2365.           2. 1492
  2366.           3. 1066
  2367.           4. None of the above.
  2368.           5. All of the above.
  2369.  
  2370.  
  2371.  
  2372.  
  2373.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 36
  2374.  
  2375.  
  2376.      Q&A Study Aid V3.91 User's Guide
  2377.  
  2378.  
  2379.      Q&ASA will NOT expand it because there is no whitespace between $NW$
  2380.      and the '?'. If, however, you use
  2381.  
  2382.      M=
  2383.      $NW$
  2384.      New World
  2385.  
  2386.      Q=
  2387.      Multiple-choice:
  2388.  
  2389.      In what year did Christopher Columbus land in the $NW$ ?
  2390.  
  2391.           1. 1592
  2392.           2. 1492
  2393.           3. 1066
  2394.           4. None of the above.
  2395.           5. All of the above.
  2396.  
  2397.      Q&ASA will expand it to
  2398.  
  2399.      Q=
  2400.      Multiple-choice:
  2401.  
  2402.      In what year did Christopher Columbus land in the New World
  2403.       ?
  2404.           1. 1592
  2405.           2. 1492
  2406.           3. 1066
  2407.           4. None of the above.
  2408.           5. All of the above.
  2409.  
  2410.      because the macro expansion includes the newline. You should not,
  2411.      therefore, attempt to use a macro in the middle of a block of text.
  2412.  
  2413.      Although Q&ASA contains a two-pass compiler, macros must be defined
  2414.      before they can be used. If you place a macro definition in the middle
  2415.      of the database definition file and use the macro identifier before
  2416.      and after it, then the identifiers that appear before the macro
  2417.      definition will NOT be expanded. Define all of your macros before
  2418.      entering the first question.
  2419.  
  2420.      As shown in the examples above, macros are expanded recursively, so if
  2421.      you place the macro identifier in any of the macro definition lines,
  2422.      you will create a self-referential macro. Q&ASA will detect this
  2423.      condition no matter how deeply recursive the reference may be. A self-
  2424.      referential macro will cause a fatal compiler error. Recursive macros
  2425.      are allowed so that you may build complex macros from simple ones if
  2426.      you wish. An obvious self-referential macro is shown below:
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 37
  2435.  
  2436.  
  2437.      Q&A Study Aid V3.91 User's Guide
  2438.  
  2439.  
  2440.      M=
  2441.      $MACRONAME$
  2442.      macro text line 1
  2443.      macro text line 2
  2444.      $MACRONAME$
  2445.  
  2446.      When Q&ASA encounters the second "$MACRONAME$", it would attempt to
  2447.      expand it using the current definition of $MACRONAME$, which would in
  2448.      turn cause it to encounter $MACRONAME$ again, and so on, until the
  2449.      program crashed. Q&ASA will detect this condition and generate an
  2450.      error message.
  2451.  
  2452.      Not all self-referential macros are obvious, however. Note that you
  2453.      can create a self-referential macro using two macros, as shown below:
  2454.  
  2455.      M=
  2456.      $MACRO 1$
  2457.      text
  2458.      text
  2459.      $MACRO 2$
  2460.  
  2461.      M=
  2462.      $MACRO 2$
  2463.      text
  2464.      text
  2465.      $MACRO 1$
  2466.  
  2467.      In this case, both macros refer to the other when expanded, creating a
  2468.      circular reference. This will also cause a fatal compiler error.
  2469.  
  2470.  
  2471.      The T= Keyword
  2472.      --------------
  2473.  
  2474.      This is the time limit keyword. Include it in the database definition
  2475.      file to specify a time limit. If you omit it, there is no time limit.
  2476.  
  2477.      The syntax is as follows:
  2478.  
  2479.           T=
  2480.           HH:MM:SS
  2481.  
  2482.      where HH is hours, MM is minutes, and SS is seconds. If the time limit
  2483.      is less than an hour, you may omit the hours field; similarly, if the
  2484.      time limit is less than a minute, you may omit the hours and minutes
  2485.      fields. The sample database definition file contains a 10-minute
  2486.      timeout, given by
  2487.  
  2488.      T=
  2489.      10:00
  2490.  
  2491.      Note:     If you specify a time limit for a database, the /FS (File/-
  2492.                Save Database) command will be disabled. A user attempting
  2493.  
  2494.  
  2495.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 38
  2496.  
  2497.  
  2498.      Q&A Study Aid V3.91 User's Guide
  2499.  
  2500.  
  2501.                to use this command will receive an error message, and the
  2502.                command will be ignored.
  2503.  
  2504.  
  2505.      The C= Keyword
  2506.      --------------
  2507.  
  2508.      This keyword is used to disable the Clear command. An individual
  2509.      taking a quiz with Q&ASA can use the Clear command to reset the score
  2510.      and essentially do the quiz twice. The author of the database defini-
  2511.      tion file may prevent this by entering
  2512.  
  2513.      C=
  2514.  
  2515.      in the database definition file. When this is done, Q&ASA will ignore
  2516.      the Clear command completely.
  2517.  
  2518.      Note that if the Clear command is allowed, by omission of the C=
  2519.      keyword, and the score file is enabled with the F= keyword (described
  2520.      later), then a score record will be written to the score file indicat-
  2521.      ing that the user cleared the score and restarted the quiz.
  2522.  
  2523.  
  2524.      The S= and R= Keywords
  2525.      ----------------------
  2526.  
  2527.      These are the mode lock keywords, where S= stands for "sequential" and
  2528.      R= stands for "random". These keywords are mutually exclusive; a
  2529.      database definition may not contain both keywords. If it does, an
  2530.      error will be generated by Q&ASA.
  2531.  
  2532.      These keywords are used to lock Q&ASA in the mode specified by the
  2533.      keyword. If you do not give either keyword, then the user of Q&ASA is
  2534.      free to use the Mode command to change modes.
  2535.  
  2536.      For example, to lock Q&ASA in sequential mode, use the following:
  2537.  
  2538.      S=
  2539.  
  2540.      and to lock Q&ASA in random mode:
  2541.  
  2542.      R=
  2543.  
  2544.      There are no other arguments. The lock remains in effect until another
  2545.      database is loaded (which may also be locked).
  2546.  
  2547.  
  2548.      The F= Keyword
  2549.      --------------
  2550.  
  2551.      The F= keyword controls logging of score information to a disk file.
  2552.      Logging is enabled by specifying a filename with the F= keyword, and
  2553.      disabled if you omit the keyword.
  2554.  
  2555.  
  2556.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 39
  2557.  
  2558.  
  2559.      Q&A Study Aid V3.91 User's Guide
  2560.  
  2561.  
  2562.      The filename you specify may be any valid DOS pathname, up to 64
  2563.      characters in length. All scoring records are appended to the file if
  2564.      it already exists, or the file will be created automatically if it
  2565.      does not exist. Q&ASA will, however, force the filename to have an
  2566.      extension of ".SCR".
  2567.  
  2568.      The score logging file may exist on a file server of a networked
  2569.      system if desired. However, Q&ASA DOES NOT SUPPORT FILE SHARING.
  2570.      Typically, and networked system will require that a file be locked
  2571.      while it is being updated so that no other network user may access the
  2572.      file until the updating has been completed. If Q&ASA is used in a
  2573.      networked system, the networking extensions to DOS must provide this
  2574.      function.
  2575.  
  2576.      If networking is to be used, but the network does not perform locking
  2577.      on a file level, then you should specify a score logging file on the
  2578.      local drive of each PC, and collect these files at a later time.
  2579.      Otherwise, you may end up with a corrupted score file.
  2580.  
  2581.      All score log records are plain ASCII (except when encryption is
  2582.      selected). An example is reproduced below.
  2583.  
  2584.      Student Name:       John Q. Public
  2585.      Database Name:      Q&ASA Sample Database
  2586.      Final Score:        72.41%
  2587.      Grade:              C
  2588.      Termination:        TIME LIMIT
  2589.  
  2590.      Started:            Monday, July 31, 1989, 15:44:44
  2591.      Completed:          Monday, July 31, 1989, 15:46:45
  2592.      Elapsed Time:       00:02:00
  2593.  
  2594.      Database File:      SAMPLE.Q&A
  2595.      Total Questions:    20
  2596.      Possible Points:    29
  2597.      Points Awarded:     21
  2598.  
  2599.      Point Matrix:
  2600.                     1     2     3     4     5     6     7     8     9    10
  2601.      0001-0010  10.34  3.45  3.45   ???  3.45   ---   ???   ---  3.45  3.45
  2602.      0011-0020   6.90  3.45  6.90  3.45   ---  3.45  3.45  6.90  3.45  6.90
  2603.  
  2604.      **********************************************************************
  2605.  
  2606.  
  2607.      The '*****....*****' forms a separator between individual records.
  2608.  
  2609.      The first block contains summary information regarding the quiz
  2610.      session. The quiz taker's name is listed along with the name of the
  2611.      database (given by the N= keyword), the final score, the letter-grade
  2612.      equivalent (or "n/a" if none were assigned), and the reason the score
  2613.      record was written to the score file. In this example, it is given as
  2614.  
  2615.  
  2616.  
  2617.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 40
  2618.  
  2619.  
  2620.      Q&A Study Aid V3.91 User's Guide
  2621.  
  2622.  
  2623.      'TIME LIMIT'. This means that the quiz taker used up the time allotted
  2624.      by the T= keyword. The possible reasons for termination are:
  2625.  
  2626.           Completed      The user answered all questions (and optionally,
  2627.                          within the time allotted by the T= keyword).
  2628.  
  2629.           TIME LIMIT     The user exceeded the time allotted by the T=
  2630.                          keyword. This reason can only be produced if a
  2631.                          time limit was given.
  2632.  
  2633.           ABORTED        This indicates that the user quit the Q&ASA ses-
  2634.                          sion before answering all questions using the /FX
  2635.                          command or by pressing Control-C or Control-Break.
  2636.  
  2637.           CLEARED        The Clear command (/MC) was used to clear the
  2638.                          score and restart the quiz. This reason cannot be
  2639.                          produced if the C= keyword is used to disable the
  2640.                          Clear command.
  2641.  
  2642.           RELOADED       The user reloaded the database, or loaded a dif-
  2643.                          ferent database, or continued a previously-saved
  2644.                          database before all questions were answered.
  2645.  
  2646.      The final score is always the ratio of the number of possible points
  2647.      to the total number of points awarded by answering correctly. Ques-
  2648.      tions that were not answered are scored as incorrect.
  2649.  
  2650.      The log record also specifies the time the database was loaded (there-
  2651.      by starting the timer, if a time limit was given), the time the quiz
  2652.      was completed or stopped (for any of the reasons given above), and the
  2653.      elapsed time.
  2654.  
  2655.      The third block of the record gives the name of the compiled database
  2656.      file, the number of questions in the file, and the number of possible
  2657.      points with the number of points awarded. Because Q&ASA supports
  2658.      weighting, the number of possible points may be entirely different
  2659.      from the number of questions.
  2660.  
  2661.      The last block is the point matrix. This shows the results of each
  2662.      question in the database, ten questions per line. Each question may
  2663.      have three possible outcomes:
  2664.  
  2665.           1.   The question was answered, and answered correctly. The point
  2666.                matrix will show the number of points awarded as a ratio of
  2667.                the number of possible points, relative to 100.
  2668.  
  2669.           2.   The question was answered, but answered incorrectly. The
  2670.                point matrix will show that no points were awarded with
  2671.                '---'.
  2672.  
  2673.           3.   The question was not answered, either by skipping over it or
  2674.                by exceeding the allotted time. The point matrix will show
  2675.                this with '???'. No points were awarded.
  2676.  
  2677.  
  2678.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 41
  2679.  
  2680.  
  2681.      Q&A Study Aid V3.91 User's Guide
  2682.  
  2683.  
  2684.      In the example score record shown, you can see that questions 6, 8,
  2685.      and 15 were answered incorrectly, questions 4 and 7 were not answered
  2686.      (most likely due to the time limit given as the reason), and the
  2687.      remaining 15 questions were answered correctly. The point breakdown
  2688.      will be described in the section on weighting.
  2689.  
  2690.  
  2691.      The E= Keyword
  2692.      --------------
  2693.  
  2694.      This keyword is used to instruct Q&ASA that the score file is to be
  2695.      encrypted. This prevents a user from completing a quiz session and
  2696.      then editing the score file manually to increase the score.
  2697.  
  2698.      When this keyword is used, the score file will not be human-readable,
  2699.      and must be converted back to plain text. This is done using the /UD
  2700.      (Utilities/Decrypt score file) command. This command, which is pass-
  2701.      word-protected, will restore the score file to plain text using the
  2702.      same file name. If the score file is, or has already been converted to
  2703.      plain text, /UD will not reprocess it.
  2704.  
  2705.      If you enter the E= keyword anywhere in the database definition file,
  2706.      Q&ASA will set a global flag that encrypts the entire score file.
  2707.  
  2708.  
  2709.      The D= Keyword
  2710.      --------------
  2711.  
  2712.      This keyword is used to disable the display of the correct answer if a
  2713.      question is answered incorrectly. If omitted, Q&ASA will display
  2714.  
  2715.                         Incorrect. The correct answer is
  2716.                                 (Correct Answer)
  2717.                             Press any key to continue
  2718.  
  2719.      The syntax of the D= keyword is as follows:
  2720.  
  2721.      D=
  2722.  
  2723.      If you enter the D= keyword anywhere in the database definition file,
  2724.      Q&ASA will set a global flag that disables this display. Q&ASA will go
  2725.      on to the next question as though the answer was correct.
  2726.  
  2727.  
  2728.      The W= Keyword
  2729.      --------------
  2730.  
  2731.      This keyword is used to assign weights to each question. The weighting
  2732.      system you use is entirely arbitrary and up to you. Q&ASA imposes only
  2733.      the restriction that you use integer weights, and that you use numbers
  2734.      between 0 and 32767 inclusive.
  2735.  
  2736.      The syntax of the W= keyword is as follows:
  2737.  
  2738.  
  2739.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 42
  2740.  
  2741.  
  2742.      Q&A Study Aid V3.91 User's Guide
  2743.  
  2744.  
  2745.      W=
  2746.      <weight>
  2747.  
  2748.      When Q&ASA encounters this keyword, it reads the weight and assigns it
  2749.      to all the questions that follow it. If Q&ASA encounters the W=
  2750.      keyword again, it will change the weight to the new weight, and assign
  2751.      the new weight to all following questions. As each question is pro-
  2752.      cessed by the Q&ASA compiler, Q&ASA keeps track of the total weight.
  2753.      When Q&ASA scores a question, it determines the point score to be the
  2754.      ratio of the total weight to that of the question in percent. This
  2755.      point score is added to the running score shown in the scoring window,
  2756.      and also appears in the point matrix in the score file (actually, the
  2757.      point score is recalculated after each question from the weights to
  2758.      avoid rounding errors).
  2759.  
  2760.      If you do not specify a weight anywhere in the database definition
  2761.      file, all questions will be weighted as one point by default.
  2762.  
  2763.      Note that this arrangement allows you total flexibility in setting up
  2764.      a weighting system. You do not have to weight each question as a
  2765.      fraction of 100, for example. Q&ASA does this for you.
  2766.  
  2767.      The sample database weights each 'fill-in' question as three points,
  2768.      each true/false as 2 points, and each multiple-choice question as one
  2769.      point. There is one 'fill-in' question, 7 'true/false' questions, and
  2770.      12 'multiple-choice' questions. The points are calculated as follows:
  2771.  
  2772.           fill-in             1    times     3 points  =    3 points
  2773.           true/false          7    times     2 points  =    14 points
  2774.           multiple-choice     12   times     1 point   =    12 points
  2775.                               ---------------------------------------
  2776.           Totals:             20 questions                  29 points
  2777.  
  2778.      There are therefore 29 possible points (as shown in the score file). A
  2779.      'fill-in' question is worth 3/29 points or 10.34 points relative to
  2780.      100. A 'true/false' question is worth 2/29 points or 6.90 points
  2781.      relative to 100, and a 'multiple-choice' question 1/29 or 3.45 points
  2782.      relative to 100. In the example score record, the user was awarded a
  2783.      total of 21 out of 29 possible points, for a score of 21/29 or 72.41%.
  2784.      Adding all of the points shown in the point matrix will produce the
  2785.      same result.
  2786.  
  2787.      Q&ASA also allows you to assign a weight of zero to one or any number
  2788.      of questions. These questions will not affect the score, as the score
  2789.      for any question is the ratio of the total weight of all questions to
  2790.      the weight of the question being scored. If you assign a weight of
  2791.      zero to all questions, the score will always be zero.
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 43
  2801.  
  2802.  
  2803.      Q&A Study Aid V3.91 User's Guide
  2804.  
  2805.  
  2806.      Conclusion
  2807.      ----------
  2808.  
  2809.      Most of these examples can be found in the sample database definition
  2810.      file, SAMPLE.DEF. Experiment with it (remember to recompile it with
  2811.      Q&ASA if you change it), but please don't pass on a modified copy to
  2812.      someone else.
  2813.  
  2814.                                   Hal Endresen
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 44
  2862.  
  2863.  
  2864.      Q&A Study Aid V3.91 User's Guide
  2865.  
  2866.  
  2867.  
  2868.                     Appendix : Q&ASA Compiler Error Messages
  2869.                     ----------------------------------------
  2870.  
  2871.      Illegal definition filename: <filename>
  2872.  
  2873.           This error is generated if you supply a database definition file
  2874.           with an extension of .Q&A.
  2875.  
  2876.      Cannot find database definition file <filename>
  2877.  
  2878.           This error indicates that Q&ASA was not able to open the database
  2879.           definition file you specified.
  2880.  
  2881.      Unable to create temporary file <filename>
  2882.  
  2883.           This error indicates that Q&ASA was not able to create its inter-
  2884.           mediate temporary file.
  2885.  
  2886.      File <def file> : Line <line> : Answer omitted
  2887.  
  2888.           You specified a question without an accompanying answer, or your
  2889.           syntax is such that Q&ASA could not determine where the answer
  2890.           is.
  2891.  
  2892.      File <def file> : Line <line> : Question omitted
  2893.  
  2894.           You specified an answer without a preceding question, or your
  2895.           syntax was such that Q&ASA could not locate the question.
  2896.  
  2897.      File <def file> : Line <line> : Macro name missing
  2898.  
  2899.           You specified a macro definition (M=), but the next line is
  2900.           blank.
  2901.  
  2902.      File <def file> : Line <line> : Weight definition missing
  2903.  
  2904.           You specified weighting (W=), but the next line is blank.
  2905.  
  2906.      File <def file> : Line <line> : Invalid weight
  2907.  
  2908.           You specified a weight that was outside the range 1..32767 or
  2909.           entered non-numeric characters.
  2910.  
  2911.      File <def file> : Line <line> : Title missing
  2912.  
  2913.           You specified the name keyword N=, but the next line is blank.
  2914.  
  2915.      File <def file> : Line <line> : Title too long - truncated
  2916.  
  2917.           The name you entered after the N= keyword is longer than 60
  2918.           characters.
  2919.  
  2920.  
  2921.  
  2922.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 45
  2923.  
  2924.  
  2925.      Q&A Study Aid V3.91 User's Guide
  2926.  
  2927.  
  2928.      File <def file> : Line <line> : Time limit definition missing
  2929.  
  2930.           You specified the time limit keyword T=, but the next line is
  2931.           blank.
  2932.  
  2933.      File <def file> : Line <line> : Invalid time limit
  2934.  
  2935.           The time limit you specified following the T= keyword is not in
  2936.           the form HH:MM:SS.
  2937.  
  2938.      File <def file> : Line <line> : Mode lock already set
  2939.  
  2940.           You specified S= and R= in the same definition file. Q&ASA is
  2941.           complaining about the second occurrence.
  2942.  
  2943.      File <def file> : Line <line> : Filename missing
  2944.  
  2945.           You specified an output score file with the F= keyword, but the
  2946.           next line is blank.
  2947.  
  2948.      File <def file> : Line <line> : Illegal filename
  2949.  
  2950.           You specified a filename after the F= keyword that has invalid
  2951.           characters or longer than 64 characters.
  2952.  
  2953.      File <def file> : Line <line> : Question line exceeds <nn> characters
  2954.  
  2955.           You entered a line in a question block that will not fit into
  2956.           Q&ASA's window.
  2957.  
  2958.      File <def file> : Line <line> : Question exceeds <nn> lines
  2959.  
  2960.           You entered a question that has too many lines.
  2961.  
  2962.      File <def file> : Line <line> : Answer line exceeds <nn> characters
  2963.  
  2964.           You entered an answer line that will not fit into Q&ASA's answer
  2965.           window.
  2966.  
  2967.      Cannot create database output file <filename>
  2968.  
  2969.           Q&ASA was unable to create the compiled database output file.
  2970.  
  2971.      Cannot open temporary file <filename>
  2972.  
  2973.           Q&ASA was unable to create its temporary file.
  2974.  
  2975.      File <def file> : Line <line> : Macro <name> is self-referential
  2976.  
  2977.           The macro specified is self-referential. This may be a direct
  2978.           self-referencing macro or it may occur as a result of a complex
  2979.           series of recursive, circular macro expansions.
  2980.  
  2981.  
  2982.  
  2983.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 46
  2984.  
  2985.  
  2986.      Q&A Study Aid V3.91 User's Guide
  2987.  
  2988.  
  2989.                                     COPYRIGHT
  2990.  
  2991.  
  2992.      This program is copyright (C) 1988, 1989, 1990, 1991, 1992 by Hal
  2993.      Endresen, Quid Pro Quo Software. All rights reserved worldwide.
  2994.  
  2995.      Q&A Study Aid is distributed as SHAREWARE, or User-Supported Software.
  2996.      You are encouraged to try the program and share it with others,
  2997.      provided that:
  2998.  
  2999.           The program is distributed in unmodified form as the complete
  3000.           archive Q&ASA391.ZIP (QASA391.ZIP on CompuServe), complete with
  3001.           documentation and the registration information on the following
  3002.           pages.
  3003.  
  3004.           No fee, charge or other consideration is requested or accepted (a
  3005.           nominal reproduction fee is acceptable if diskettes or CD-ROMs
  3006.           are the distribution medium, provided no charge is specified or
  3007.           required for the program itself).
  3008.  
  3009.           The program is not distributed in conjunction with any other
  3010.           product.
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 47
  3045.  
  3046.  
  3047.      Q&A Study Aid V3.91 User's Guide
  3048.  
  3049.  
  3050.  
  3051.                              DEFINITION OF SHAREWARE
  3052.                              -----------------------
  3053.  
  3054.      Shareware distribution gives users a chance to try software before
  3055.      buying it. If you try a Shareware program and continue using it, you
  3056.      are required to register and pay for its use. With registration, you
  3057.      get anything from the simple right to continue using the software,
  3058.      technical support services, or an updated program with printed manual.
  3059.  
  3060.      Copyright laws apply to both Shareware and commercial software, and
  3061.      the copyright holder retains all rights, with a few specific excep-
  3062.      tions as stated below. Shareware authors are accomplished programmers,
  3063.      just like commercial authors, and the programs are of comparable
  3064.      quality (in both cases, there are good programs and bad ones!). The
  3065.      main difference is in the method of distribution. The author specifi-
  3066.      cally grants the right to copy and distribute the software, either to
  3067.      all and sundry or to a specific group. For example, some authors
  3068.      require written permission before a commercial disk vendor may copy
  3069.      their Shareware.
  3070.  
  3071.      Shareware is a distribution method, not a type of software. You should
  3072.      find software that suits your needs and pocketbook, whether it's
  3073.      commercial or Shareware. The Shareware system makes fitting your needs
  3074.      easier, because you can try before you buy. And because the overhead
  3075.      is low, prices are low also. Shareware has the ultimate money-back
  3076.      guarantee - if you don't use the product, you don't pay for it.
  3077.  
  3078.                              DISCLAIMER - AGREEMENT
  3079.                              ----------------------
  3080.  
  3081.      Users of Q&A Study Aid must accept this disclaimer of warranty: "Q&A
  3082.      Study Aid is supplied as is. The author disclaims all warranties,
  3083.      expressed or implied, including, without limitation, all warranties of
  3084.      merchantability and of fitness for any purpose. The author assumes no
  3085.      liability for damages, direct or consequential, pecuniary or other-
  3086.      wise, which may result from the use of Q&A Study Aid."
  3087.  
  3088.      Q&A Study Aid is a "shareware program" and is provided at no charge to
  3089.      the user for evaluation. Feel free to share it with your friends, but
  3090.      please do not give it away altered or as part of another system. The
  3091.      essence of "user-supported" software is to provide personal computer
  3092.      users with quality software without high prices, and provides an
  3093.      incentive for programmers to continue to develop new products. If you
  3094.      find this program useful and find that you are using Q&A Study Aid and
  3095.      continue to it after a reasonable trial period (30 days), you must
  3096.      make a registration payment of $20.00 (US) to Quid Pro Quo Software.
  3097.      The $20.00 registration fee will license one copy for use on any one
  3098.      computer at any one time. You must treat this software just like a
  3099.      book. An example is that this software may be used by any number of
  3100.      people and may be freely moved from one computer location to another,
  3101.      so long as there is no possibility of it being used at one location
  3102.  
  3103.  
  3104.  
  3105.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 48
  3106.  
  3107.  
  3108.      Q&A Study Aid V3.91 User's Guide
  3109.  
  3110.  
  3111.      while it is also being used at another - just as a book cannot be read
  3112.      by two different persons at the same time.
  3113.  
  3114.      Commercial or governmental users of Q&A Study Aid must register and
  3115.      pay for their copies of Q&A Study Aid within 30 days of first use or
  3116.      their license is withdrawn. Site licenses may be purchased according
  3117.      to the following schedule (all prices are in US dollars):
  3118.  
  3119.           One copy                 $20.00
  3120.           Two copies               $35.00
  3121.           3-10 copies              $10.00 plus $10.00 per copy
  3122.           11-30 copies             $50.00 plus $5.00 per copy
  3123.           More than 30 copies      $100.00 plus $2.00 per copy
  3124.  
  3125.      Anyone distributing Q&A Study Aid for any kind of remuneration MUST
  3126.      specify in any literature or advertising that Q&A Study Aid is SHARE-
  3127.      WARE, and as such, requires registration and payment to the author of
  3128.      the program above and beyond any payment the buyer makes for a copy of
  3129.      the program on some distribution media.
  3130.  
  3131.      You are encouraged to pass a copy of Q&A Study Aid along to your
  3132.      friends for evaluation. Please encourage them to register their copy
  3133.      if they find the program useful and continue using it. All registered
  3134.      users will receive a copy of the latest version of the Q&A Study Aid
  3135.      system if the registration form specifies any version prior to the
  3136.      latest version, and all registered users will be notified of upgrades
  3137.      and improvements. As a registered user, you are also entitled to free
  3138.      replacement of the program should a maintenance release be made within
  3139.      a period of one year following your original registration.
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 49
  3167.  
  3168.  
  3169.      Q&A Study Aid V3.91 User's Guide
  3170.  
  3171.  
  3172.  
  3173.                                  SPECIAL OFFER!
  3174.                                  --------------
  3175.  
  3176.      Registered users of any ASP program may purchase a 1-year subscription
  3177.      to Shareware Magazine, normally $20.00, for just $12.95. Simply call
  3178.      (800) 245-6717 and give Special Order #: 2262 in order to use Master-
  3179.      card or VISA. You may also send a check for $12.95 to:
  3180.  
  3181.           Shareware Magazine Subscription
  3182.           1030 D E. Duane Ave.
  3183.           Sunnyvale, CA 94086
  3184.  
  3185.      Include the Special Order number along with your name and mailing
  3186.      address.
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 50
  3228.  
  3229.  
  3230.      Q&A Study Aid V3.91 User's Guide
  3231.  
  3232.  
  3233.  
  3234.                       Q&A STUDY AID V3.91 REGISTRATION FORM
  3235.  
  3236.      Name _______________________________________________________________
  3237.  
  3238.      Title ______________________________________________________________
  3239.  
  3240.      Company ____________________________________________________________
  3241.  
  3242.      Address ____________________________________________________________
  3243.  
  3244.      City __________________________________ State ______ Zip ___________
  3245.  
  3246.      Country _______________________________ Phone ______________________
  3247.  
  3248.      SERIAL NUMBER FROM OPENING SCREEN __________________________________
  3249.  
  3250.      NUMBER OF COPIES DESIRED (see schedule below) ______________________
  3251.  
  3252.      Display System _____________________________________________________
  3253.      DOS Version ________________________________________________________
  3254.      PC Make/Model/CPU __________________________________________________
  3255.      Fixed Disk Type/Capacity ___________________________________________
  3256.      Floppy Disks _______________________________________________________
  3257.      System RAM _________________________________________________________
  3258.  
  3259.      To register, send this form and a check for the appropriate amount to
  3260.      Quid Pro Quo Software at the address shown below. Site licenses are
  3261.      granted according to the following schedule (in US dollars):
  3262.  
  3263.           One copy                 $20.00
  3264.           Two copies               $35.00
  3265.           3-10 copies              $10.00 plus $10.00 per copy
  3266.           11-30 copies             $50.00 plus $5.00 per copy
  3267.           > 30 copies              $100.00 plus $2.00 per copy
  3268.  
  3269.                               Quid Pro Quo Software
  3270.                                   P.O. Box 1248
  3271.                            Cedar Rapids, IA 52406-1248
  3272.  
  3273.      Registered users will receive notification of upgrades of Q&A Study
  3274.      Aid, a registration number to remove the registration notice from the
  3275.      opening screen, and support either via CompuServe [73760,2032] or by
  3276.      mail. You will be entitled to maintenance releases for a period of one
  3277.      year following original registration. Non-registered users may make
  3278.      inquiries as to the suitability of this program for their particular
  3279.      purpose and to report bugs, errors, or desired features.
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.      Copyright (C) 1988-1991 Hal Endresen, Quid Pro Quo Software    Page 51